Docs
Use these operations to interact with external docs on entities in Cortex.
Required permissions
Your API key must have the Edit entities
permission.
Operations
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Name of the OpenAPI spec to return. If you have multiple OpenAPI specs configured for your entity as x-cortex-links
, use this parameter to ensure the correct spec is returned. If this parameter is not specified, we will return the first OpenAPI spec found.
Successfully found documentation
Documentation not found
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
GET /api/v1/catalog/{tagOrId}/documentation/openapi HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"spec": "text"
}
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Stringified JSON representation of the OpenAPI spec
Successfully updated documentation
Invalid request
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
PUT /api/v1/catalog/{tagOrId}/documentation/openapi HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"spec": "text"
}
{
"spec": "text"
}
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Successfully deleted documentation
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
DELETE /api/v1/catalog/{tagOrId}/documentation/openapi HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
No content
Last updated
Was this helpful?