Custom Data
Use these operations to interact with custom data in Cortex.
Required permissions
Edit entities: Your API key must have the Edit entities permission.
Operations
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
The tag (x-cortex-tag) or unique, auto-generated identifier for the entity.
Number of results to return per page, between 1 and 1000. Default 250.
250Page number to return, 0-indexed. Default 0.
0Successfully retrieved custom data. If using pagination, we do not return page, total, or totalPages in the response. An empty array is returned once you reach the end.
Entity 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}/custom-data?pageSize=250&page=0 HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateUpdated": "2025-11-14T21:50:02.601Z",
"description": "text",
"id": 1,
"key": "text",
"source": "YAML",
"value": {}
}
]Use this endpoint when attempting to delete custom data where the key contains non-alphanumeric characters. Otherwise, use the standard API under Custom Data.
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
Entity tag (x-cortex-tag), supports non-alphanumeric characters
When set, returns the entity's value at this key. Otherwise, returns all custom data key/values for the entity.
Successfully retrieved custom data
Entity 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/custom-data?tag=text HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateUpdated": "2025-11-14T21:50:02.601Z",
"description": "text",
"id": 1,
"key": "text",
"source": "YAML",
"value": {}
}
]All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
The tag (x-cortex-tag) or unique, auto-generated identifier for the entity.
Successfully retrieved custom data for key
Custom data not found for given entity and key
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}/custom-data/{key} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"dateUpdated": "2025-11-14T21:50:02.601Z",
"description": "text",
"id": 1,
"key": "text",
"source": "YAML",
"value": {}
}All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
The tag (x-cortex-tag) or unique, auto-generated identifier for the entity.
When true, overrides values that were defined in the catalog descriptor. Will be overwritten the next time the catalog descriptor is processed.
Successfully created data
Invalid custom data request
Entity not found
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
POST /api/v1/catalog/{tagOrId}/custom-data HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6
"text"{
"dateUpdated": "2025-11-14T21:50:02.601Z",
"description": "text",
"id": 1,
"key": "text",
"source": "YAML",
"value": {}
}Refer to the Webhook section of the Custom Data docs for more information. This API is preconfigured in your workspace settings under Custom Integrations. The UUID corresponds to a custom data key, as well as a jq command that maps the data in this payload to an entity in your workspace.
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
OK
No content
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
POST /api/v1/custom-integrations/data/{uuid} HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2
{}No content
Add multiple key/values of custom data to multiple entities
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
When true, overrides values that were defined in the catalog descriptor. Will be overwritten the next time the catalog descriptor is processed.
Successfully created/updated custom data
Invalid custom data 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/custom-data HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
{
"errors": {
"ANY_ADDITIONAL_PROPERTY": "NOT_FOUND"
},
"values": [
{
"dateUpdated": "2025-11-14T21:50:02.601Z",
"description": "text",
"id": 1,
"key": "text",
"source": "YAML",
"value": {}
}
]
}All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
The tag (x-cortex-tag) or unique, auto-generated identifier for the entity.
When true, overrides values that were defined in the catalog descriptor. Will be overwritten the next time the catalog descriptor is processed.
Successfully deleted custom data
No content
Entity not found
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}/custom-data?key=text HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Use this endpoint when attempting to delete custom data where the key contains non-alphanumeric characters. Otherwise, use the standard API under Custom Data.
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
Successfully deleted custom data
No content
Entity not found
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/custom-data?tag=text&key=text HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Last updated
Was this helpful?