Share this page

# Collections

A resource collection is a set of resource instances. For example, the defects collection contains resources that represent defects.

In this topic:

## Overview

A resource collection is a set of resource instances. For example, the defects collection contains resources that represent defects.

- Resource collections may contain 0->N resource instances.

- An entity collection is a resource collection of entities (see instances).

- A resource collection is identified using the following syntax.

  Level | Syntax
  --- | ---
  Site | `<scheme name>:<authority>/admin/<resource_collection>` Site level permissions are applied.
  Workspace | `<scheme name>:<authority>/api/shared_spaces/<space_id>/workspaces/<workspace_id>/<resource_collection>` Workspace level permissions are applied.
  Space | `<scheme name>:<authority>/api/shared_spaces/<space_id>/<resource_collection>` Space level permissions are applied.

## URIs

The following are the URI formats for the different levels.

Level | Syntax
--- | ---
Workspace | https://<server>:<port>/api/shared_spaces/<space_id>/workspaces/{workspace_id}/<entity_collection>
Space | https://<server>:<port>/api/shared_spaces/<space_id>/<entity_collection>
Site | `https://<server>:<port>/admin/<entity_collection>`

### Using the defects collection

`https://<server>:<port>/api/shared_spaces/<space_id>/workspaces/<workspace_id>/defects`

For the syntax for specifying parameters in URIs, see Variables and values.

Note: Throughout this document, the example URIs are abbreviated, without the server and port context.

`http://<server>:<port>/api/shared_spaces/<space_id>/workspaces/<workspace_id>/<entities>`

Becomes:

`.../api/shared_spaces/<space_id>/workspaces/<workspace_id>/<entities>`

## Supported request methods

Resource collection supports the following HTTP request methods.

Method | Description | Supports
--- | --- | ---
GET | Retrieve the data | Supports: Filtering, field selection, sorting, and pagination.
POST | Create new entities | None
PUT | Update existing entities | Supports: Filtering.
DELETE | Delete existing entities | Supports: Delete by filter.

## Actions on collections

You can perform the following actions on resource collections:

- Query a collection

- POST: Create instances in a collection

- PUT: Update multiple instances

- DELETE: Delete a collection

## See also

- Interactive API client
- Entry points
- Entities

- Relations

https://admhelp.microfocus.com Software Delivery Management 8942
Tips to improve your search results... OpenText™ Software Delivery Management Help Center OpenText™ Software Delivery Management Help 26.3 All View Local Help Center View Online Help Center Version: