curl --request POST \
--url https://{cluster}.cognitedata.com/api/v1/projects/{project}/ai/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"externalId": "<string>",
"name": "<string>",
"description": "<string>",
"instructions": "<string>",
"model": "azure/gpt-4.1-mini",
"runtimeVersion": "<string>",
"tools": []
}
]
}
'{
"items": [
{
"createdTime": 123,
"externalId": "<string>",
"lastUpdatedTime": 123,
"name": "<string>",
"ownerId": "<string>",
"runtimeVersion": "<string>",
"description": "<string>",
"instructions": "<string>",
"model": "azure/gpt-4.1-mini",
"tools": []
}
]
}Add or update (upsert) Atlas AI agents.
curl --request POST \
--url https://{cluster}.cognitedata.com/api/v1/projects/{project}/ai/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"externalId": "<string>",
"name": "<string>",
"description": "<string>",
"instructions": "<string>",
"model": "azure/gpt-4.1-mini",
"runtimeVersion": "<string>",
"tools": []
}
]
}
'{
"items": [
{
"createdTime": 123,
"externalId": "<string>",
"lastUpdatedTime": 123,
"name": "<string>",
"ownerId": "<string>",
"runtimeVersion": "<string>",
"description": "<string>",
"instructions": "<string>",
"model": "azure/gpt-4.1-mini",
"tools": []
}
]
}Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.
A list of agents to create or update.
1 elementShow child attributes
Successful Response
A list of created agents.
Show child attributes
Was this page helpful?