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/families
- Productionhttps://api.apiera.io/v1/families
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/families?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 families.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family has been soft-deleted. |
{ "items": [ { … } ], "pagination": { "page": 0, "size": 0, "totalItems": 0, "totalPages": 0 } }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families
- Productionhttps://api.apiera.io/v1/families
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.apiera.io/_mock/openapi/v1/families \
-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 family.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family 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": "laptops", "displayName": "Laptops", "description": "Product family for laptop computers." }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}
- Productionhttps://api.apiera.io/v1/families/{familyUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'The requested family.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family 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": "laptops", "displayName": "Laptops", "description": "Product family for laptop computers." }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}
- Productionhttps://api.apiera.io/v1/families/{familyUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}' \
-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 family.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family 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": "laptops", "displayName": "Laptops", "description": "Product family for laptop computers." }
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}
- Productionhttps://api.apiera.io/v1/families/{familyUuid}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Optional detailed description of the family's purpose and scope.
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/bulk
- Productionhttps://api.apiera.io/v1/families/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.apiera.io/_mock/openapi/v1/families/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 families.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family has been soft-deleted. |
Detailed description of the family's purpose and which products it applies to.
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "code": "string", "displayName": "string", "description": "string" } ]
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/bulk
- Productionhttps://api.apiera.io/v1/families/bulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
https://docs.apiera.io/_mock/openapi/v1/families/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 families.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family has been soft-deleted. |
Detailed description of the family's purpose and which products it applies to.
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "code": "string", "displayName": "string", "description": "string" } ]
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/{familyUuid}/actions/lifecycle
- Productionhttps://api.apiera.io/v1/families/{familyUuid}/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/families/{familyUuid}/actions/lifecycle' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"transition": "activate"
}'The family after the lifecycle transition.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family 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": "laptops", "displayName": "Laptops", "description": "Product family for laptop computers." }
Lifecycle transition to apply to a product family.
| Enum Value | Description |
|---|---|
| activate | Activates the family. |
| deactivate | Deactivates the family. |
| remove | Removes the family. |
| restore | Restores the family. |
- Mock serverhttps://docs.apiera.io/_mock/openapi/v1/families/bulk/actions/lifecycle
- Productionhttps://api.apiera.io/v1/families/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/families/bulk/actions/lifecycle \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"transition": "activate",
"uuids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}'The families after the lifecycle transition.
Identifier of the parent family for hierarchical organization. Null if this is a root family.
Timestamp when this family was created.
Timestamp when this family was last modified.
Timestamp when this family was removed. Null if not removed.
Lifecycle status of a product family.
| Enum Value | Description |
|---|---|
| draft | The initial state of the family. |
| active | The family is active and available for use. |
| inactive | The family is temporarily disabled. |
| removed | The family has been soft-deleted. |
Detailed description of the family's purpose and which products it applies to.
[ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "parentUuid": "a234027b-494b-4285-a8ce-894cd0943051", "createdAt": "2025-11-23T14:15:22.123456Z", "updatedAt": "2025-11-23T14:15:22.123456Z", "removedAt": "2025-11-23T14:15:22.123456Z", "status": "draft", "code": "string", "displayName": "string", "description": "string" } ]