Endpoint catalog
List public categories
GET /api/v1/catalog/categories
GET /api/v1/catalog/categories
- operationId:
listPublicCategories - Stability: stable
- Authentication: None
- Idempotency: none
Parameters
This operation declares no parameters.
Request body
This operation declares no request body.
Responses and errors
| Status | Description | Schema |
|---|---|---|
200 | Successful response | #/components/schemas/PublicCatalogCategoryListResponse |
400 | Request does not match the public contract | #/components/schemas/PublicErrorResponse |
401 | Authentication failed | #/components/schemas/PublicErrorResponse |
403 | Insufficient authorization scope | #/components/schemas/PublicErrorResponse |
404 | Public resource not found | #/components/schemas/PublicErrorResponse |
409 | Idempotency or state conflict | #/components/schemas/PublicErrorResponse |
429 | Rate limited | #/components/schemas/PublicErrorResponse |
Rate limiting
The spec declares a 429 response.
The Retry-After header is not declared by the spec.
- Top-level shape:
{ data: array, meta?: object }
Success response schema
{
"$ref": "#/components/schemas/PublicCatalogCategoryListResponse"
}
Error response schema
{
"$ref": "#/components/schemas/PublicErrorResponse"
}
Generated from the verified public-only OpenAPI artifact; no speculative request example is provided.