### GET /pages/preview Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /pages/preview ```markdown ### Parameters - **status** (union, query, optional): Filter by status - **language** (union, query, optional): Filter by language - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **tag** (union, query, optional): Filter by tag - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse_PagePreviewResponseModel_** - **items** (array (PagePreviewResponseModel)) (required) Array items: - **id** (string) (required) - **title** (string) (required) - **slug** (string) (required) - **menu_label** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **tags** (array (string)) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **translation_of_id** (string) (required) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/pages/preview?status=value&language=value&field=title&order=asc&tag=value&page=1&limit=10" ``` ``` -------------------------------- ### GET /articles Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /articles ```markdown ### Parameters - **status** (union, query, optional): Filter by status - **category** (union, query, optional): Filter by category ID - **tag** (union, query, optional): Filter by tag - **keyword** (union, query, optional): Search in title and content - **language** (union, query, optional): Filter by language - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse_ArticleResponseModel_** - **items** (array (ArticleResponseModel)) (required) Array items: - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **author** (string) (required) - **source** (object) (required) - **type** (string (internal|external|user_submitted|ai_generated)) (required) ("internal"|"external"|"user_submitted"|"ai_generated") - **name** (string) (required) - **url** (string) - **author** (string) - **published_date** (integer) - **license** (string) - **categories** (array (string)): List of category IDs - **tags** (array (string)) (required) - **summary** (string) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) - **updated_at** (string) - **published_at** (string) - **media_objects_placements** (array (object)) (required) - **custom_fields** (object) (required) - **translation_of_id** (string) - **file_urls** (object) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/articles?status=value&category=value&tag=value&keyword=value&language=value&field=title&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### GET /articles/preview Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /articles/preview ```markdown ### Parameters - **status** (union, query, optional): Filter by status - **category** (union, query, optional): Filter by category ID - **tag** (union, query, optional): Filter by tag - **keyword** (union, query, optional): Search in title and content - **language** (union, query, optional): Filter by language - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse_ArticlePreviewResponseModel_** - **items** (array (ArticlePreviewResponseModel)) (required) Array items: - **id** (string) (required) - **title** (string) (required) - **slug** (string) (required) - **author** (string) (required) - **source** (object) (required) - **type** (string (internal|external|user_submitted|ai_generated)) (required) ("internal"|"external"|"user_submitted"|"ai_generated") - **name** (string) (required) - **url** (string) - **author** (string) - **published_date** (integer) - **license** (string) - **categories** (array (string)): List of category IDs - **tags** (array (string)) (required) - **summary** (string) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) - **updated_at** (string) - **published_at** (string) - **translation_of_id** (string) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/articles/preview?status=value&category=value&tag=value&keyword=value&language=value&field=title&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### GET /micro-copy Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy ```markdown ### Parameters - **language** (union, query, optional): Filter by language - **tags** (union, query, optional): Filter by tags (comma-separated) - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of MicroCopyResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy?language=value&tags=value" ``` ``` -------------------------------- ### GET /categories Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories ```markdown ### Parameters - **parent_id** (union, query, optional): Filter by parent category ID - **language** (union, query, optional): Filter by language - **keyword** (union, query, optional): Search in name and description - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse** - **items** (array (unknown)) (required) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories?parent_id=value&language=value&keyword=value&field=name&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### GET /micro-copy/by-key/{key} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy/by-key/{key} ```markdown ### Parameters - **key** (string, path, required): The key of the micro copy - **language** (union, query, optional): Language filter - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **MicroCopyResponseModel** - **id** (string) (required) - **key** (string) (required) - **value** (string) (required) - **language** (string) (required) - **translation_of** (string) (required) - **tags** (string) (required) - **created_at** (string) (required) - **updated_at** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy/by-key/{key}?language=value" ``` ``` -------------------------------- ### GET /pages Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /pages ```markdown ### Parameters - **status** (union, query, optional): Filter by status - **language** (union, query, optional): Filter by language - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **tag** (union, query, optional): Filter by tag - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse_PageResponseModel_** - **items** (array (PageResponseModel)) (required) Array items: - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **menu_label** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **tags** (array (string)) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **media_objects_placements** (array (object)) (required) - **translation_of_id** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/pages?status=value&language=value&field=title&order=asc&tag=value&page=1&limit=10" ``` ``` -------------------------------- ### GET /micro-copy/language/{language} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy/language/{language} ```markdown ### Parameters - **language** (string, path, required): The language code - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of MicroCopyResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy/language/{language}" ``` ``` -------------------------------- ### GET /available-languages Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /available-languages ```markdown ### Parameters - **tenant_id** (string, query, required) ### Responses #### 200 - Successful Response - Array of string #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/available-languages?tenant_id=string" ``` ``` -------------------------------- ### GET /articles/by-slug/{slug} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /articles/by-slug/{slug} ```markdown ### Parameters - **slug** (string, path, required): The slug of the article - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **ArticleResponseModel** - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **author** (string) (required) - **source** (object) (required) - **type** (string (internal|external|user_submitted|ai_generated)) (required) ("internal"|"external"|"user_submitted"|"ai_generated") - **name** (string) (required) - **url** (string) - **author** (string) - **published_date** (integer) - **license** (string) - **categories** (array (string)): List of category IDs - **tags** (array (string)) (required) - **summary** (string) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) - **updated_at** (string) - **published_at** (string) - **media_objects_placements** (array (object)) (required) - **custom_fields** (object) (required) - **translation_of_id** (string) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/articles/by-slug/{slug}" ``` ``` -------------------------------- ### GET /micro-copy/count Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy/count ```markdown ### Parameters - **language** (union, query, optional): Filter by language - **tags** (union, query, optional): Filter by tags (comma-separated) - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy/count?language=value&tags=value" ``` ``` -------------------------------- ### GET /custom-collections/by-slug/{slug} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/by-slug/{slug} ```markdown ### Parameters - **slug** (string, path, required): The slug of the custom collection - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CustomCollectionResponseModel** - **id** (string) (required) - **name** (string) (required) - **slug** (string) (required) - **description** (string) (required) - **language** (string) (required) - **fields** (array (FieldDefinitionModel)) (required) Array items: - **name** (string) (required): Field name (used as identifier) - **label** (string) (required): Display label - **type** (string (text|textarea|number|date|date_range|boolean|select|multi_select|reference|image|file|rich_text|url|email|color)) (required) ("text"|"textarea"|"number"|"date"|"date_range"|"boolean"|"select"|"multi_select"|"reference"|"image"|"file"|"rich_text"|"url"|"email"|"color") - **required** (boolean): Whether this field is required - **multiple** (boolean): Whether multiple values are allowed - **description** (string) - **default_value** (unknown) - **related_collection** (string) - **options** (array (object)) - **validation** (object) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/by-slug/{slug}" ``` ``` -------------------------------- ### GET /pages/by-slug/{slug} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /pages/by-slug/{slug} ```markdown ### Parameters - **slug** (string, path, required): The slug of the page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PageResponseModel** - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **menu_label** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **tags** (array (string)) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **media_objects_placements** (array (object)) (required) - **translation_of_id** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/pages/by-slug/{slug}" ``` ``` -------------------------------- ### GET /categories/by-slug/{slug} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories/by-slug/{slug} ```markdown ### Parameters - **slug** (string, path, required): The slug of the category - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CategoryResponseModel** - **id** (string) (required) - **name** (string) (required) - **slug** (string) (required) - **description** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **created_at** (string) (required) - **updated_at** (string) (required) - **translation_of_id** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories/by-slug/{slug}" ``` ``` -------------------------------- ### GET /micro-copy/translations/{translation_of} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy/translations/{translation_of} ```markdown ### Parameters - **translation_of** (string, path, required): The ID of the source micro copy - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of MicroCopyResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy/translations/{translation_of}" ``` ``` -------------------------------- ### GET /search Source: https://public-api.adaptocms.com/v1/openapi.json Search across articles, pages, and collection items by keyword. Results are filled in waterfall order: collection items first, then articles, then pages. Returns a flat list capped at limit. ```markdown ### Parameters - **keyword** (string, query, required): Search term - **scope** (union, query, optional): Scopes: 'articles', 'pages', 'collections', or a collection UUID - **limit** (integer, query, optional): Max results - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of SearchResultModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/search?keyword=string&scope=value&limit=20" ``` ``` -------------------------------- ### GET /custom-collections Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections ```markdown ### Parameters - **status** (union, query, optional): Filter by status - **language** (union, query, optional): Filter by language - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse** - **items** (array (unknown)) (required) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections?status=value&language=value&field=name&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### GET /articles/{article_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /articles/{article_id} ```markdown ### Parameters - **article_id** (string, path, required): The ID of the article - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **ArticleResponseModel** - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **author** (string) (required) - **source** (object) (required) - **type** (string (internal|external|user_submitted|ai_generated)) (required) ("internal"|"external"|"user_submitted"|"ai_generated") - **name** (string) (required) - **url** (string) - **author** (string) - **published_date** (integer) - **license** (string) - **categories** (array (string)): List of category IDs - **tags** (array (string)) (required) - **summary** (string) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) - **updated_at** (string) - **published_at** (string) - **media_objects_placements** (array (object)) (required) - **custom_fields** (object) (required) - **translation_of_id** (string) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/articles/{article_id}" ``` ``` -------------------------------- ### GET /custom-collections/{collection_id}/items/preview Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/{collection_id}/items/preview ```markdown ### Parameters - **collection_id** (string, path, required): The ID of the custom collection - **status** (union, query, optional): Filter by status - **language** (union, query, optional): Filter by language - **translation_of_id** (union, query, optional): Filter by translation source ID - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse_CustomCollectionItemPreviewResponseModel_** - **items** (array (CustomCollectionItemPreviewResponseModel)) (required) Array items: - **id** (string) (required) - **collection_id** (string) (required) - **title** (string) (required) - **slug** (string) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **translation_of_id** (string) (required) - **meta_data** (object) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/{collection_id}/items/preview?status=value&language=value&translation_of_id=value&field=title&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### GET /micro-copy/{micro_copy_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /micro-copy/{micro_copy_id} ```markdown ### Parameters - **micro_copy_id** (string, path, required): The ID of the micro copy - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **MicroCopyResponseModel** - **id** (string) (required) - **key** (string) (required) - **value** (string) (required) - **language** (string) (required) - **translation_of** (string) (required) - **tags** (string) (required) - **created_at** (string) (required) - **updated_at** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/micro-copy/{micro_copy_id}" ``` ``` -------------------------------- ### GET /pages/{page_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /pages/{page_id} ```markdown ### Parameters - **page_id** (string, path, required): The ID of the page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PageResponseModel** - **id** (string) (required) - **title** (string) (required) - **content** (string) (required) - **slug** (string) (required) - **menu_label** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **tags** (array (string)) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **media_objects_placements** (array (object)) (required) - **translation_of_id** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/pages/{page_id}" ``` ``` -------------------------------- ### GET /categories/{category_id}/articles Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories/{category_id}/articles ```markdown ### Parameters - **category_id** (string, path, required): The ID of the category - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of string #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories/{category_id}/articles" ``` ``` -------------------------------- ### GET /categories/{category_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories/{category_id} ```markdown ### Parameters - **category_id** (string, path, required): The ID of the category - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CategoryResponseModel** - **id** (string) (required) - **name** (string) (required) - **slug** (string) (required) - **description** (string) (required) - **parent_id** (string) (required) - **language** (string) (required) - **created_at** (string) (required) - **updated_at** (string) (required) - **translation_of_id** (string) (required) - **custom_fields** (object) (required) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories/{category_id}" ``` ``` -------------------------------- ### GET /categories/{category_id}/subcategories Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories/{category_id}/subcategories ```markdown ### Parameters - **category_id** (string, path, required): The ID of the parent category - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of CategoryResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories/{category_id}/subcategories" ``` ``` -------------------------------- ### GET /custom-collections/{collection_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/{collection_id} ```markdown ### Parameters - **collection_id** (string, path, required): The ID of the custom collection - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CustomCollectionResponseModel** - **id** (string) (required) - **name** (string) (required) - **slug** (string) (required) - **description** (string) (required) - **language** (string) (required) - **fields** (array (FieldDefinitionModel)) (required) Array items: - **name** (string) (required): Field name (used as identifier) - **label** (string) (required): Display label - **type** (string (text|textarea|number|date|date_range|boolean|select|multi_select|reference|image|file|rich_text|url|email|color)) (required) ("text"|"textarea"|"number"|"date"|"date_range"|"boolean"|"select"|"multi_select"|"reference"|"image"|"file"|"rich_text"|"url"|"email"|"color") - **required** (boolean): Whether this field is required - **multiple** (boolean): Whether multiple values are allowed - **description** (string) - **default_value** (unknown) - **related_collection** (string) - **options** (array (object)) - **validation** (object) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/{collection_id}" ``` ``` -------------------------------- ### GET /custom-collections/{collection_id}/items/by-slug/{slug} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/{collection_id}/items/by-slug/{slug} ```markdown ### Parameters - **collection_id** (string, path, required): The ID of the custom collection - **slug** (string, path, required): The slug of the custom collection item - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CustomCollectionItemResponseModel** - **id** (string) (required) - **collection_id** (string) (required) - **title** (string) (required) - **slug** (string) (required) - **data** (object) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **media_objects_placements** (array (object)) (required) - **translation_of_id** (string) (required) - **meta_data** (object) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/{collection_id}/items/by-slug/{slug}" ``` ``` -------------------------------- ### GET /articles/{article_id}/translations Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /articles/{article_id}/translations ```markdown ### Parameters - **article_id** (string, path, required): The ID of the article - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of ArticleResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/articles/{article_id}/translations" ``` ``` -------------------------------- ### GET /categories/{category_id}/translations Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /categories/{category_id}/translations ```markdown ### Parameters - **category_id** (string, path, required): The ID of the category - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response - Array of CategoryResponseModel #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/categories/{category_id}/translations" ``` ``` -------------------------------- ### GET /custom-collections/{collection_id}/items/{item_id} Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/{collection_id}/items/{item_id} ```markdown ### Parameters - **collection_id** (string, path, required): The ID of the custom collection - **item_id** (string, path, required): The ID of the custom collection item - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **CustomCollectionItemResponseModel** - **id** (string) (required) - **collection_id** (string) (required) - **title** (string) (required) - **slug** (string) (required) - **data** (object) (required) - **language** (string) (required) - **status** (string (draft|published|archived|deleted)) (required) ("draft"|"published"|"archived"|"deleted") - **created_at** (string) (required) - **updated_at** (string) (required) - **published_at** (string) (required) - **media_objects_placements** (array (object)) (required) - **translation_of_id** (string) (required) - **meta_data** (object) - **file_urls** (object) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/{collection_id}/items/{item_id}" ``` ``` -------------------------------- ### GET /custom-collections/{collection_id}/items Source: https://public-api.adaptocms.com/v1/openapi.json API endpoint for GET /custom-collections/{collection_id}/items ```markdown ### Parameters - **collection_id** (string, path, required): The ID of the custom collection - **status** (union, query, optional): Filter by status - **language** (union, query, optional): Filter by language - **translation_of_id** (union, query, optional): Filter by translation source ID - **field** (union, query, optional): Field to sort by - **order** (union, query, optional): Sort order (asc or desc) - **page** (integer, query, optional): Page number starting from 1 - **limit** (integer, query, optional): Number of items per page - **x-api-key** (string, header, required) ### Responses #### 200 - Successful Response **PaginatedResponse** - **items** (array (unknown)) (required) - **total** (integer) (required) - **page** (integer) (required) - **limit** (integer) (required) - **pages** (integer) (required) #### 422 - Validation Error **HTTPValidationError** - **detail** (array (ValidationError)) Array items: - **loc** (array (union)) (required) - **msg** (string) (required) - **type** (string) (required) ### Example Usage ```bash curl -X GET "/v1/custom-collections/{collection_id}/items?status=value&language=value&translation_of_id=value&field=title&order=asc&page=1&limit=10" ``` ``` -------------------------------- ### Schema: SourceType Source: https://public-api.adaptocms.com/v1/openapi.json Schema definition for SourceType ```markdown ## Schema: SourceType Schema definition for SourceType **Type:** string ``` -------------------------------- ### Schema: ArticleStatus Source: https://public-api.adaptocms.com/v1/openapi.json Schema definition for ArticleStatus ```markdown ## Schema: ArticleStatus Schema definition for ArticleStatus **Type:** string ```