The Apiera REST API provides programmatic access to the Apiera platform, enabling seamless integration with your existing systems and workflows.
Apiera REST API (1.1.0)
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections
- Productionhttps://api.apiera.io/v1/collections
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/collections?uuids%5Beq%5D=497f6eca-6276-4993-bfeb-53cbbbba6f08&codes%5Beq%5D=string&code%5Bcontains%5D=string&code%5Bstarts%5D=string&code%5Bends%5D=string&code%5Border%5D=string&displayNames%5Beq%5D=string&displayName%5Bcontains%5D=string&displayName%5Bstarts%5D=string&displayName%5Bends%5D=string&displayName%5Border%5D=string&statuses%5Beq%5D=draft&status%5Border%5D=string&parentUuids%5Beq%5D=497f6eca-6276-4993-bfeb-53cbbbba6f08&isRemoved%5Beq%5D=true&createdAt%5Beq%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Bmin%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Bmax%5D=2025-11-23T14%3A15%3A22.123456Z&createdAt%5Border%5D=string&updatedAt%5Beq%5D=2025-11-23T14%3A15%3A22.123456Z&updatedAt%5Bmin%5D=2025-11-23T14%3A15%3A22.123456Z&updatedAt%5Bmax%5D=2025-11-23T14%3A15%3A22.123456Z&updatedAt%5Border%5D=string&page=0&size=0' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'A paginated list of collections.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
Identifier of the parent collection. Null for root collections.
{ "items": [ { … } ], "pagination": { "page": 0, "size": 0, "totalItems": 0, "totalPages": 0 } }
Identifier of the parent collection for hierarchical nesting. Null for root collections.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections
- Productionhttps://api.apiera.io/v1/collections
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.apiera.io/_mock/openapi/v1/collections \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"parentUuid": "a234027b-494b-4285-a8ce-894cd0943051",
"code": "string",
"displayName": "string",
"description": "string"
}'The created collection.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2025-01-15T10:30:00.000000Z", "updatedAt": "2025-01-15T10:30:00.000000Z", "status": "draft", "code": "spring-2025", "displayName": "Spring 2025", "description": "Spring 2025 seasonal collection." }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}
- Productionhttps://api.apiera.io/v1/collections/{collectionUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'The requested collection.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2025-01-15T10:30:00.000000Z", "updatedAt": "2025-01-15T10:30:00.000000Z", "status": "draft", "code": "spring-2025", "displayName": "Spring 2025", "description": "Spring 2025 seasonal collection." }
Request
Updates an existing collection. Only provided fields are modified; omitted fields remain unchanged.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}
- Productionhttps://api.apiera.io/v1/collections/{collectionUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"parentUuid": "a234027b-494b-4285-a8ce-894cd0943051",
"code": "string",
"displayName": "string",
"description": "string"
}'The updated collection.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2025-01-15T10:30:00.000000Z", "updatedAt": "2025-01-15T10:30:00.000000Z", "status": "draft", "code": "spring-2025", "displayName": "Spring 2025", "description": "Spring 2025 seasonal collection." }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}
- Productionhttps://api.apiera.io/v1/collections/{collectionUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Request
Creates multiple collections in a single operation. All collections are created in draft status.
Identifier of the parent collection for hierarchical nesting. Null for root collections.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/bulk
- Productionhttps://api.apiera.io/v1/collections/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.apiera.io/_mock/openapi/v1/collections/bulk \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"parentUuid": "a234027b-494b-4285-a8ce-894cd0943051",
"code": "string",
"displayName": "string",
"description": "string"
}
]'The created collections.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "code": "string", "displayName": "string", "description": "string" } ]
Request
Updates multiple collections in a single operation. Only provided fields are modified for each collection.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/bulk
- Productionhttps://api.apiera.io/v1/collections/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
https://docs.apiera.io/_mock/openapi/v1/collections/bulk \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
"parentUuid": "a234027b-494b-4285-a8ce-894cd0943051",
"code": "string",
"displayName": "string",
"description": "string"
}
]'The updated collections.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "code": "string", "displayName": "string", "description": "string" } ]
Request
Transitions a collection to a different lifecycle state. Valid transitions depend on the current status.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}/actions/lifecycle
- Productionhttps://api.apiera.io/v1/collections/{collectionUuid}/actions/lifecycle
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://docs.apiera.io/_mock/openapi/v1/collections/{collectionUuid}/actions/lifecycle' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"transition": "activate"
}'The collection after the lifecycle transition.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
{ "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2025-01-15T10:30:00.000000Z", "updatedAt": "2025-01-15T10:30:00.000000Z", "status": "active", "code": "spring-2025", "displayName": "Spring 2025", "description": "Spring 2025 seasonal collection." }
Lifecycle transition to apply to a collection.
| Enum Value | Description |
|---|---|
| activate | Activates the collection. |
| deactivate | Deactivates the collection. |
| remove | Removes the collection. |
| restore | Restores the collection. |
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/collections/bulk/actions/lifecycle
- Productionhttps://api.apiera.io/v1/collections/bulk/actions/lifecycle
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
https://docs.apiera.io/_mock/openapi/v1/collections/bulk/actions/lifecycle \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"transition": "activate",
"uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}'The collections after the lifecycle transition.
Timestamp when this collection was created.
Timestamp when this collection was last modified.
Timestamp when this collection was removed. Null if not removed.
Lifecycle status of a collection.
| Enum Value | Description |
|---|---|
| draft | The initial state of the collection. |
| active | The collection is active and available for use. |
| inactive | The collection is temporarily disabled. |
| removed | The collection has been soft-deleted. |
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "code": "string", "displayName": "string", "description": "string" } ]