Groups
Use these operations to interact with groups on entities in Cortex.
Required permissions
Your API key must have the Edit entities
permission.
Operations
Authorizations
Path parameters
tagOrIdstringRequired
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Query parameters
pageSizeinteger · int32RequiredDefault:
Number of results to return per page, between 1 and 1000. Default 250.
250
pageinteger · int32RequiredDefault:
Page number to return, 0-indexed. Default 0.
0
Responses
200
Successfully retrieved groups
application/json
404
Entity not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
get
GET /api/v1/catalog/{tagOrId}/groups HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*
{
"groups": [
{
"tag": "text"
}
],
"page": 1,
"total": 1,
"totalPages": 1
}
Authorizations
Path parameters
tagOrIdstringRequired
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Body
Responses
200
Successfully created group memberships
application/json
400
Bad Request
application/json
404
Entity not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
put
PUT /api/v1/catalog/{tagOrId}/groups HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"groups": [
{
"tag": "text"
}
]
}
{
"groups": [
{
"tag": "text"
}
],
"page": 1,
"total": 1,
"totalPages": 1
}
Authorizations
Path parameters
tagOrIdstringRequired
The tag (x-cortex-tag
) or unique, auto-generated identifier for the entity.
Body
Responses
200
Successfully deleted group memberships
400
Bad Request
application/json
404
Entity not found
application/json
429
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
application/problem+json
delete
DELETE /api/v1/catalog/{tagOrId}/groups HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"groups": [
{
"tag": "text"
}
]
}
No content
Last updated
Was this helpful?