Download OpenAPI specification:Download
Cortex V6 REST apis for managing: Agents, Connections, Managed content, Secrets, Sessions, Skills, and Tasks
Operations for granting/revoking access to different internal resources
List activations in a project
projectId required | string |
filter | string |
limit | number <double> |
skip | number <double> |
sort | string |
{- "success": true,
- "message": "string",
- "details": null,
- "activations": null
}
Get activation by activationId and project
projectId required | string |
activationId required | string |
verbose | string |
report | string |
{- "success": true,
- "message": "string",
- "details": null
}
List activation by agent name
projectId required | string |
agentName required | string |
filter | string |
limit | number <double> |
skip | number <double> |
sort | string |
{- "success": true,
- "message": "string",
- "details": null,
- "activations": null
}
Gets a list of agents within a project
projectId required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "skills": [
- {
- "name": "string",
- "_projectId": "string",
- "title": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "deleted": true,
- "version": 0
}
]
}
Save an agent within a project
projectId required | string |
name required | string |
type required | string |
image required | string |
description | string |
command | Array of strings |
string or number | |
scaleCount | number <double> |
k8sResources | Array of any |
environmentVariables | any |
{- "name": "string",
- "type": "string",
- "image": "string",
- "description": "string",
- "command": [
- "string"
], - "port": "string",
- "scaleCount": 0,
- "k8sResources": [
- null
], - "environmentVariables": null
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "version": 0,
- "created": "2019-08-24T14:15:22Z"
}
Describes an agent within a project
projectId required | string |
name required | string |
verbose | boolean |
{- "name": "string",
- "camel": "string",
- "title": "string",
- "description": "string",
- "inputs": [
- null
], - "outputs": [
- null
], - "properties": [
- null
], - "tags": [
- {
- "label": "string",
- "value": "string"
}
]
}
Get version details for an agent, including: version, updatedAt, and author
projectId required | string |
name required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "versions": [
- {
- "version": 0,
- "updatedAt": "2019-08-24T14:15:22Z",
- "author": "string"
}
]
}
List an agent's snapshots
projectId required | string |
name required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "snapshots": [
- {
- "snapshotId": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "agentName": "string",
- "createdBy": "2019-08-24T14:15:22Z",
- "title": "string",
- "isTip": true,
- "agent": null,
- "dependencies": null
}
]
}
Get an snapshot using it's unique id.
projectId required | string |
snapshotId required | string |
verbose | boolean |
deps | boolean |
output | string |
{- "snapshotId": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "agentName": "string",
- "createdBy": "2019-08-24T14:15:22Z",
- "title": "string",
- "isTip": true,
- "agent": null,
- "dependencies": null,
- "success": true,
- "message": "string",
- "details": null,
- "code": 0
}
Invoke agent service
projectId required | string
|
agentName required | string
|
serviceName required | string
|
sync | string
|
scheduleCron | string
|
scheduleName | string
|
sessionId | string |
payload | object |
properties | object |
correlationId | string |
{- "sessionId": "string",
- "payload": {
- "property1": null,
- "property2": null
}, - "properties": {
- "property1": null,
- "property2": null
}, - "correlationId": "string"
}
{- "success": true,
- "message": "string",
- "details": null,
- "activationId": "string",
- "response": {
- "property1": null,
- "property2": null
}
}
Get agent service execution plan
projectId required | string |
agentName required | string |
serviceName required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "plan": null,
- "diagram": "string"
}
List activation by agent name
projectId required | string |
agentName required | string |
filter | string |
limit | number <double> |
skip | number <double> |
sort | string |
{- "success": true,
- "message": "string",
- "details": null,
- "activations": null
}
Create and manage connections to Data Sources such as files, databases, and cloud storage; connections are used to create datasets in Fabric.
Get connection type by name
name required | string Name of an existing connection type to fetch |
{- "group": "string",
- "type": "string",
- "typeIcon": "string",
- "groupIcon": "string",
- "contentType": [
- "string"
], - "dataConnectors": [
- "string"
], - "title": "string",
- "name": "string",
- "description": "string",
- "tags": [
- {
- "_id": null,
- "label": "string",
- "value": "string"
}
], - "_id": null,
- "hidden": true,
- "connectionParams": [
- {
- "validValues": [
- null
], - "name": "string",
- "title": "string",
- "description": "string",
- "type": "string",
- "required": true,
- "secure": true,
- "defaultValue": null,
- "validation": "string",
- "errorMessage": "string"
}
], - "connectionQueryParams": [
- null
], - "connectionWriteParams": [
- null
]
}
Fetch supported connection types
filter | string Mongo Filter to filter request |
skip | number <double> Skip number |
limit | number <double> Limit the number of objects |
sort | string Sort criteria |
{- "success": true,
- "connectionTypes": [
- {
- "group": "string",
- "type": "string",
- "typeIcon": "string",
- "groupIcon": "string",
- "contentType": [
- "string"
], - "dataConnectors": [
- "string"
], - "title": "string",
- "name": "string",
- "description": "string",
- "tags": [
- {
- "_id": null,
- "label": "string",
- "value": "string"
}
], - "_id": null,
- "hidden": true,
- "connectionParams": [
- {
- "validValues": [
- null
], - "name": "string",
- "title": "string",
- "description": "string",
- "type": "string",
- "required": true,
- "secure": true,
- "defaultValue": null,
- "validation": "string",
- "errorMessage": "string"
}
], - "connectionQueryParams": [
- null
], - "connectionWriteParams": [
- null
]
}
]
}
{- "success": true,
- "connections": [
- {
- "_id": null,
- "name": "string",
- "title": "string",
- "description": "string",
- "connectionType": "string",
- "allowWrite": true,
- "params": [
- {
- "name": "string",
- "value": "string",
- "_id": null
}
], - "contentType": "string",
- "camel": "string",
- "allowRead": true,
- "tags": [
- {
- "_id": null,
- "label": "string",
- "value": "string"
}
], - "createdAt": null,
- "updatedAt": null,
- "_version": 0
}
], - "message": "string",
- "details": [
- null
]
}
Create a connection
projectId required | string |
_id | any |
name required | string |
title required | string |
description | string |
connectionType | string |
allowWrite | boolean |
Array of objects (_Params) | |
contentType | string or null |
camel | string |
allowRead | boolean |
Array of objects (Tag1) | |
createdAt | any |
updatedAt | any |
_version | number <double> |
{- "_id": null,
- "name": "string",
- "title": "string",
- "description": "string",
- "connectionType": "string",
- "allowWrite": true,
- "params": [
- {
- "name": "string",
- "value": "string",
- "_id": null
}
], - "contentType": "string",
- "camel": "string",
- "allowRead": true,
- "tags": [
- {
- "_id": null,
- "label": "string",
- "value": "string"
}
], - "createdAt": null,
- "updatedAt": null,
- "_version": 0
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0
}
Fetch a connection
projectId required | string |
name required | string |
{- "_id": null,
- "name": "string",
- "title": "string",
- "description": "string",
- "connectionType": "string",
- "allowWrite": true,
- "params": [
- {
- "name": "string",
- "value": "string",
- "_id": null
}
], - "contentType": "string",
- "camel": "string",
- "allowRead": true,
- "tags": [
- {
- "_id": null,
- "label": "string",
- "value": "string"
}
], - "createdAt": null,
- "updatedAt": null,
- "_version": 0
}
Get service status for all platform services, return 500 status code if any services are unhealthy. This request is unauthenticated.
{- "version": "string",
- "healths": [
- {
- "health": null,
- "version": "string",
- "name": "string",
- "healthy": true,
- "message": "string"
}
], - "deployType": "string",
- "endpoints": null,
- "serverTs": 0
}
Get service status for all platform services, return a 218 status code if unhealthy. This request is unauthenticated. This allows for http clients to safely fetch status and not throw a request error, if there are any unhealthy services.
{- "version": "string",
- "healths": [
- {
- "health": null,
- "version": "string",
- "name": "string",
- "healthy": true,
- "message": "string"
}
], - "deployType": "string",
- "endpoints": null,
- "serverTs": 0
}
Get service status for all platform services, return a 218 status code if unhealthy. Require authentication This allows for http clients to safely fetch status and not throw a request error, if there are any unhealthy services. Include endpoints object containing useful URLs
{- "version": "string",
- "healths": [
- {
- "health": null,
- "version": "string",
- "name": "string",
- "healthy": true,
- "message": "string"
}
], - "deployType": "string",
- "endpoints": null,
- "serverTs": 0
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "data": [
- {
- "name": "string",
- "title": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "_createAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_createdBy": "string",
- "description": "string",
- "scope": [
- "string"
], - "componentTypes": [
- "string"
], - "componentName": "string",
- "resportCount": 0
}
]
}
{- "name": "string",
- "title": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "_createAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_createdBy": "string",
- "description": "string",
- "scope": [
- "string"
], - "componentTypes": [
- "string"
], - "componentName": "string",
- "resportCount": 0
}
Run an assessment against its: types, components, and scopes
name required | string |
{- "name": "string",
- "title": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "_createAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_createdBy": "string",
- "description": "string",
- "scope": [
- "string"
], - "componentTypes": [
- "string"
], - "componentName": "string",
- "resportCount": 0
}
List reports for a given assessment
name required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "data": [
- {
- "name": "string",
- "title": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "_createAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_createdBy": "string",
- "description": "string",
- "assessmentId": "string",
- "reportId": "string",
- "totalCount": null,
- "summary": null,
- "detail": null,
- "params": null
}
]
}
Get report for a given reportId and assessment
name required | string |
reportId required | string |
{- "name": "string",
- "title": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "_createAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_createdBy": "string",
- "description": "string",
- "assessmentId": "string",
- "reportId": "string",
- "totalCount": null,
- "summary": null,
- "detail": null,
- "params": null
}
Managed Content provides access to Cortex-managed file storage.
Manage model experiments and runs during model building and evaluation
Gets a list of models within a project
projectId required | string |
{- "success": true,
- "models": [
- {
- "name": "string",
- "title": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "deleted": true,
- "version": 0,
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
]
}
]
}
Create or update a model within a project
projectId required | string |
name required | string |
type required | string |
status required | string |
title required | string |
source | string |
mode | string |
camel | string |
description | string |
Array of objects (Tag2) | |
Array of objects (Properties) |
{- "name": "string",
- "type": "string",
- "status": "string",
- "title": "string",
- "source": "string",
- "mode": "string",
- "camel": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "properties": [
- {
- "validValues": [
- "string"
], - "name": "string",
- "type": "string",
- "value": "string",
- "required": true,
- "secure": true
}
]
}
{- "success": true,
- "version": 0,
- "created": "2019-08-24T14:15:22Z",
- "id": "string",
- "modelId": "string"
}
Describe a model within a project
projectId required | string |
name required | string |
{- "name": "string",
- "type": "string",
- "status": "string",
- "title": "string",
- "camel": "string",
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "properties": [
- {
- "validValues": [
- "string"
], - "name": "string",
- "type": "string",
- "value": "string",
- "required": true,
- "secure": true
}
], - "description": "string",
- "source": "string",
- "mode": "string"
}
List runs for a model within a project
projectId required | string |
name required | string |
{- "runs": [
- {
- "_id": "string",
- "runId": "string",
- "_projectId": "string",
- "experimentName": "string",
- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "artifacts": null,
- "params": null,
- "metrics": null,
- "meta": null
}
]
}
Gets a list of tags for a particular resource(Eg Model) within a project
projectId required | string |
resource required | string |
{- "success": true,
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
]
}
Gets a list of experiments within a project
projectId required | string |
{- "experiments": [
- {
- "_version": 0,
- "name": "string",
- "title": "string",
- "description": "string",
- "meta": null,
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "modelId": "string",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z"
}
]
}
Create or update an experiment within a project
projectId required | string |
name required | string |
required | Array of objects (Tag2) |
title | string |
description | string |
meta | any |
modelId | string |
{- "name": "string",
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "title": "string",
- "description": "string",
- "meta": null,
- "modelId": "string"
}
{- "_version": 0,
- "name": "string",
- "_projectId": "string",
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "title": "string",
- "description": "string",
- "meta": null,
- "modelId": "string"
}
Describe an experiment within a project
projectId required | string |
name required | string |
{- "_version": 0,
- "name": "string",
- "title": "string",
- "description": "string",
- "meta": null,
- "tags": [
- {
- "label": "string",
- "value": "string",
- "_id": "string"
}
], - "modelId": "string",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z"
}
List runs for an experiment within a project
projectId required | string |
name required | string |
{- "runs": [
- {
- "_id": "string",
- "runId": "string",
- "_projectId": "string",
- "experimentName": "string",
- "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "artifacts": null,
- "metrics": null,
- "meta": null,
- "params": null
}
]
}
Create run for an experiment within a project
projectId required | string |
name required | string |
_id required | string |
runId required | string |
_projectId required | string |
experimentName required | string |
startTime | number <double> |
endTime | number <double> |
took | number <double> |
_createdAt required | string <date-time> |
_updatedAt required | string <date-time> |
artifacts | any |
metrics | any |
meta | any |
params | any |
{- "_id": "string",
- "runId": "string",
- "_projectId": "string",
- "experimentName": "string",
- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "artifacts": null,
- "metrics": null,
- "meta": null,
- "params": null
}
{- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "artifacts": null,
- "metrics": null,
- "meta": null,
- "params": null
}
Describe an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
{- "_id": "string",
- "runId": "string",
- "_projectId": "string",
- "experimentName": "string",
- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "artifacts": null,
- "params": null,
- "metrics": null,
- "meta": null
}
Update an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
_id required | string |
runId required | string |
_projectId required | string |
experimentName required | string |
startTime | number <double> |
endTime | number <double> |
took | number <double> |
_createdAt required | string <date-time> |
_updatedAt required | string <date-time> |
metrics | any |
meta | any |
params | any |
{- "_id": "string",
- "runId": "string",
- "_projectId": "string",
- "experimentName": "string",
- "startTime": 0,
- "endTime": 0,
- "took": 0,
- "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "metrics": null,
- "meta": null,
- "params": null
}
{- "success": true,
- "message": "string"
}
Update a metric of an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
metric required | string |
value required | any |
{- "value": null
}
{- "success": true,
- "message": "string"
}
Update a param of an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
param required | string |
value required | any |
{- "value": null
}
{- "success": true,
- "message": "string"
}
Update a meta of an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
meta required | string |
value required | any |
{- "value": null
}
{- "success": true,
- "message": "string"
}
Get an artifact of an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
artifact required | string |
{- "success": true,
- "message": "string"
}
Delete an artifact of an experiment-run within a project
projectId required | string |
name required | string |
runId required | string |
artifact required | string |
{- "success": true,
- "message": "string"
}
Gets a list of secret names within a project
projectId required | string |
list | boolean recursively list secrets |
keys | string Comma separated list of secret key names |
{- "data": [
- null
]
}
Create sessions to cache and share data between skills and agents
List sessions by projectId sdsdsdsd dsd ssdsdsds
projectId required | string |
limit | number <double> |
{- "success": true,
- "message": "string",
- "details": null,
- "sessions": [
- {
- "sessionId": "string",
- "ttl": 0,
- "description": "string"
}
]
}
Create session in project
projectId required | string |
sessionId | string |
ttl | number <double> |
description | string |
state | object |
{- "sessionId": "string",
- "ttl": 0,
- "description": "string",
- "state": {
- "property1": null,
- "property2": null
}
}
{- "success": true,
- "message": "string",
- "details": null,
- "state": null,
- "ttl": "string",
- "description": "string"
}
Get session state by projectId and sessionId
projectId required | string |
sessionId required | string |
subKey | string |
{- "success": true,
- "message": "string",
- "details": null,
- "state": null,
- "ttl": "string",
- "description": "string"
}
Update sessions state by projectId and sessionId
projectId required | string |
sessionId required | string |
null
{- "success": true,
- "message": "string",
- "details": null,
- "state": null,
- "ttl": "string",
- "description": "string"
}
Skills wrap and route messages to actions, these are the smallest computational building blocks
Gets a list of skills within a project
projectId required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "skills": [
- {
- "name": "string",
- "_projectId": "string",
- "title": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "deleted": true,
- "version": 0
}
]
}
Save a skill within a project
projectId required | string |
name required | string |
type required | string |
image required | string |
description | string |
command | Array of strings |
string or number | |
scaleCount | number <double> |
k8sResources | Array of any |
environmentVariables | any |
{- "name": "string",
- "type": "string",
- "image": "string",
- "description": "string",
- "command": [
- "string"
], - "port": "string",
- "scaleCount": 0,
- "k8sResources": [
- null
], - "environmentVariables": null
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "version": 0
}
Describes a skill within a project
projectId required | string |
name required | string |
{- "name": "string",
- "camel": "string",
- "title": "string",
- "description": "string",
- "inputs": [
- null
], - "outputs": [
- null
], - "properties": [
- null
], - "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "actions": [
- null
]
}
Get skill logs for an action within a project
projectId required | string |
name required | string |
actionName required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "logs": [
- null
]
}
Gets a list of actions within a project
projectId required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "actions": [
- {
- "name": "string",
- "type": "string",
- "image": "string",
- "description": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "deleted": true,
- "version": 0
}
]
}
Save an action within a project
projectId required | string |
name required | string |
type required | string |
image required | string |
description | string |
command | Array of strings |
string or number | |
scaleCount | number <double> |
k8sResources | Array of any |
environmentVariables | any |
{- "name": "string",
- "type": "string",
- "image": "string",
- "description": "string",
- "command": [
- "string"
], - "port": "string",
- "scaleCount": 0,
- "k8sResources": [
- null
], - "environmentVariables": null
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "version": 0
}
Describes an action within a project
projectId required | string |
name required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "action": {
- "_isDeleted": true,
- "_projectId": "string",
- "_createdBy": "string",
- "name": "string",
- "description": "string",
- "image": "string",
- "type": "string",
- "command": [
- "string"
], - "port": "string",
- "scaleCount": 0,
- "k8sResources": [
- null
], - "environmentVariables": null,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "_version": 0
}
}
Invoke skill
projectId required | string
|
skillName required | string
|
inputName required | string
|
sync | string
|
sessionId | string |
payload | object |
properties | object |
correlationId | string |
{- "sessionId": "string",
- "payload": {
- "property1": null,
- "property2": null
}, - "properties": {
- "property1": null,
- "property2": null
}, - "correlationId": "string"
}
{- "success": true,
- "message": "string",
- "details": null,
- "activationId": "string",
- "response": {
- "property1": null,
- "property2": null
}
}
Managed Job Skill executions: list, get logs, manage schedules, and delete.
List tasks in project
projectId required | string |
actionName | string |
limit | number <double> |
skillName | string |
scheduled | string |
filter | string |
skip | number <double> |
sort | string |
{- "success": true,
- "message": "string",
- "details": null,
- "tasks": null
}
Delete task by taskId, removes kubernetes task, job, and pod from cluster
projectId required | string
|
taskId required | string
|
{- "success": true,
- "message": "string",
- "details": null
}
Get task logs by taskId
projectId required | string |
taskId required | string
|
raw | string
|
"string"
Pause scheduled task by taskId, new jobs will not be scheduled until task is resumed, existing jobs will continue running until completion.
projectId required | string |
taskId required | string |
{- "success": true,
- "message": "string",
- "details": null
}
Resume paused scheduled task by taskId, resume scheduling future jobs, missed schedules will not be scheduled.
projectId required | string |
taskId required | string |
{- "success": true,
- "message": "string",
- "details": null
}
Types defined the expected structure of message passed to Agent endpoints/services
Save a type within a project
projectId required | string |
name required | string |
camel required | string |
title required | string |
description required | string |
required | Array of objects (Tag) |
parameters required | Array of any |
{- "name": "string",
- "camel": "string",
- "title": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "parameters": [
- null
]
}
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0
}
Get list of types within a project
projectId required | string |
{- "success": true,
- "message": "string",
- "details": null,
- "code": 0,
- "types": [
- {
- "name": "string",
- "_projectId": "string",
- "title": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "deleted": true,
- "version": 0
}
]
}
Get a type within a project
projectId required | string |
name required | string |
{- "_id": "string",
- "_projectId": "string",
- "_createdBy": "string",
- "camel": "string",
- "name": "string",
- "title": "string",
- "description": "string",
- "tags": [
- {
- "label": "string",
- "value": "string"
}
], - "parameters": [
- "string"
], - "_createdAt": "2019-08-24T14:15:22Z",
- "_updatedAt": "2019-08-24T14:15:22Z",
- "_version": 0
}
Operations for granting/revoking access to different internal resources
Creates a role with an initial set of grants
role required | string |
project required | string |
resource required | string |
actions required | Array of strings |
effect required | string |
{- "role": "string",
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Assign roles to a project
project required | string |
roles required | Array of strings |
{- "project": "string",
- "roles": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Unassign roles from a project
project required | string |
roles required | Array of strings |
{- "project": "string",
- "roles": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Get role mappings for an external group
external required | string Name of the external group to retrieve |
roles | boolean Include role grants |
users | boolean Include users |
{- "externalGroup": "string",
- "users": [
- "string"
], - "roles": [
- {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
]
}
Describe a role and optionally include grants and users
role required | string Name of the role to describe |
grants | boolean Include grants |
users | boolean Include users |
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
], - "role": {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
}
Describe a role and include the users associated with the role
role required | string Name of the role |
users | boolean |
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
], - "role": {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
}
Assign users to a role
role required | string Name of the role to assign users to |
users required | Array of strings List of users to be assigned to the role |
{- "users": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Unassign users from a role
role required | string Name of the role to remove users from |
users required | Array of strings List of users to be removed from the role |
{- "users": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Describe a role and include the associated grants
role required | string Name of the role to fetch |
grants | boolean |
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
], - "role": {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
}
Creates a grant associated with a role, will create a role if no grants exist
role required | string Name of the role to assign the grant to |
project required | string |
resource required | string |
actions required | Array of strings |
effect required | string |
{- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Deletes a grant associated with a role (grant * * * * deletes all but leaves assignments until role is deleted)
role required | string Name of the role to remove the grant from |
project required | string |
resource required | string |
actions required | Array of strings |
effect required | string |
{- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Create a cortex role to external group mapping
role required | string Name of the cortex role to assign |
externalGroup required | string |
{- "externalGroup": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Delete a mapping for an external group to internal role
role required | string Name of the cortex role |
external required | string Name of the external group to grant access |
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Assign users to a project
project required | string |
users required | Array of strings |
{- "project": "string",
- "users": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Unassign users from a project
project required | string |
users required | Array of strings |
{- "project": "string",
- "users": [
- "string"
]
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Lists grants and roles associated with self (params --grants and --roles)
grants | boolean include grants |
roles | boolean include roles |
{- "user": "string",
- "projects": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "roles": [
- {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
], - "externalGroups": [
- "string"
]
}
Lists grants and roles associated with a user (params --grants and --roles)
user required | string Username to list RBAC permissions and roles |
{- "user": "string",
- "projects": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "roles": [
- {
- "role": "string",
- "projects": [
- "string"
], - "externalGroups": [
- "string"
], - "grants": [
- {
- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
], - "users": [
- "string"
]
}
], - "externalGroups": [
- "string"
]
}
Creates a grant associated with a user
user required | string Username to add grants onto |
project required | string |
resource required | string |
actions required | Array of strings |
effect required | string |
{- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Deletes a grant or all grants associated with a user (grant * * * * deletes all).
user required | string Name of the user to remove grants from |
project required | string |
resource required | string |
actions required | Array of strings |
effect required | string |
{- "project": "string",
- "resource": "string",
- "actions": [
- "string"
], - "effect": "string"
}
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
]
}
Endpoint for configuring a Docker Registry to use Cortex as the authentication provider. https://cognitivescale.github.io/cortex-charts/docs/infrastructure/private-registry#configure-docker-registry-with-fabric-token-auth https://docs.docker.com/registry/spec/auth/token/
{- "token": "string"
}
Retrieves config for generating personal access token
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
], - "config": {
- "audience": "string",
- "jwk": {
- "crv": "string",
- "x": "string",
- "d": "string",
- "kty": "string",
- "kid": "string",
- "alg": "string"
}, - "issuer": "string",
- "service": true,
- "url": "string",
- "username": "string"
}
}
Create a service user/identity within cortex that can query cortex api's, rbac/roles must be added/controlled separately.
user required | string Name of the user to create |
{- "success": true,
- "message": "string",
- "code": 0,
- "details": [
- null
], - "config": {
- "audience": "string",
- "jwk": {
- "crv": "string",
- "x": "string",
- "d": "string",
- "kty": "string",
- "kid": "string",
- "alg": "string"
}, - "issuer": "string",
- "service": true,
- "url": "string",
- "username": "string"
}, - "token": "string"
}