Skip to main content
PUT
/
agents
/
{id}

​
Endpoint

PUT https://gateway.orkeia.ai/agents/{id}

​
Headers

authorization:  <your_token>
Content-Type: application/json

​
Path Parameters

{
  "id": "Agent ID (required)"
}

​
Request Body

All fields of Agents, except for the id, are mutable.
FieldTypeDescription
namestringName of the agent
enabledbooleanWhether the agent is active
modelstring / ModelID of the model or AI model
autobooleanWhether the agent is active
reasoningbooleanWhether the agent has permission to process thought
publisherstringID of who created the agent
temperaturenumber (0.0 to 1.0)Controls the randomness of the model’s responses. Values closer to 0 tend to be more deterministic, while closer to 1 tend to be more variable.
rolestringRole that the agent will play
objectivestringObjective of the agent in each interaction
referenciesstringTextual reference that the agent will use
can.delegatebooleanCan the agent delegate tasks?
can_codebooleanCan the agent program?
multimodalbooleanDoes the agent have the ability to interact with multiple modes (image, text, audio)?
sectorsarray(String)Array of sectors that will use the agent
toolsarray(String) / array(Tools)Array of tools that the agent can use
knowledgeBasesarray(String) / array(KnowledgeBase)Array of knowledge bases that can be used by the agent
{
  "name": "New agent name",
  "enabled": true
}

​
Example (cURL)

curl -X PUT "https://gateway.orkeia.ai/agents/agent123" \
  -H "authorization:  <your_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "New agent name", "enabled": true}'

​
Responses

​
Response - Success

{
"status": "OK",
   "data": { "true" }
}

​
500 — Bad Request

{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}

​
400 — Client Error

{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}