Chapter 12. Collection Service
12.1. Collection Service
12.1.1. CreateCollection
POST /v1/collections
12.1.1.1. Description
12.1.1.2. Parameters
12.1.1.2.1. Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body | X |
12.1.1.3. Return Type
12.1.1.4. Content Type
- application/json
12.1.1.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.1.6. Samples
12.1.2. DeleteCollection
DELETE /v1/collections/{id}
12.1.2.1. Description
12.1.2.2. Parameters
12.1.2.2.1. Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id | X | null |
12.1.2.3. Return Type
Object
12.1.2.4. Content Type
- application/json
12.1.2.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. |
|
0 | An unexpected error response. |
12.1.2.6. Samples
12.1.3. DryRunCollection
POST /v1/collections/dryrun
12.1.3.1. Description
12.1.3.2. Parameters
12.1.3.2.1. Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body | X |
12.1.3.3. Return Type
12.1.3.4. Content Type
- application/json
12.1.3.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.3.6. Samples
12.1.4. GetCollection
GET /v1/collections/{id}
12.1.4.1. Description
12.1.4.2. Parameters
12.1.4.2.1. Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id | X | null |
12.1.4.2.2. Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
options.withMatches | - | null | ||
options.filterQuery.query | - | null | ||
options.filterQuery.pagination.limit | - | null | ||
options.filterQuery.pagination.offset | - | null | ||
options.filterQuery.pagination.sortOption.field | - | null | ||
options.filterQuery.pagination.sortOption.reversed | - | null | ||
options.filterQuery.pagination.sortOption.aggregateBy.aggrFunc | - | UNSET | ||
options.filterQuery.pagination.sortOption.aggregateBy.distinct | - | null |
12.1.4.3. Return Type
12.1.4.4. Content Type
- application/json
12.1.4.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.4.6. Samples
12.1.5. GetCollectionCount
GET /v1/collectionscount
12.1.5.1. Description
12.1.5.2. Parameters
12.1.5.2.1. Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
query.query | - | null | ||
query.pagination.limit | - | null | ||
query.pagination.offset | - | null | ||
query.pagination.sortOption.field | - | null | ||
query.pagination.sortOption.reversed | - | null | ||
query.pagination.sortOption.aggregateBy.aggrFunc | - | UNSET | ||
query.pagination.sortOption.aggregateBy.distinct | - | null |
12.1.5.3. Return Type
12.1.5.4. Content Type
- application/json
12.1.5.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.5.6. Samples
12.1.6. ListCollectionSelectors
GET /v1/collections/selectors
12.1.6.1. Description
12.1.6.2. Parameters
12.1.6.3. Return Type
12.1.6.4. Content Type
- application/json
12.1.6.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.6.6. Samples
12.1.7. ListCollections
GET /v1/collections
12.1.7.1. Description
12.1.7.2. Parameters
12.1.7.2.1. Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
query.query | - | null | ||
query.pagination.limit | - | null | ||
query.pagination.offset | - | null | ||
query.pagination.sortOption.field | - | null | ||
query.pagination.sortOption.reversed | - | null | ||
query.pagination.sortOption.aggregateBy.aggrFunc | - | UNSET | ||
query.pagination.sortOption.aggregateBy.distinct | - | null |
12.1.7.3. Return Type
12.1.7.4. Content Type
- application/json
12.1.7.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |
12.1.7.6. Samples
12.1.8. UpdateCollection
PATCH /v1/collections/{id}
12.1.8.1. Description
12.1.8.2. Parameters
12.1.8.2.1. Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id | X | null |
12.1.8.2.2. Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body | X |
12.1.8.3. Return Type
12.1.8.4. Content Type
- application/json
12.1.8.5. Responses
Code | Message | Datatype |
---|---|---|
200 | A successful response. | |
0 | An unexpected error response. |