Skip to main content
PUT
/
v1
/
agents
/
{agent_id}
Update a base agent.
curl --request PUT \
  --url https://api.roe-ai.com/v1/agents/{agent_id}/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "disable_cache": true,
  "cache_failed_jobs": true
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "disable_cache": true,
  "cache_failed_jobs": true,
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "engine_class_id": "<string>",
  "current_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "job_count": 123,
  "most_recent_job": "2023-11-07T05:31:56Z",
  "engine_name": "<string>",
  "tags": "<string>",
  "creator": {
    "id": 123,
    "email": "[email protected]",
    "first_name": "<string>",
    "last_name": "<string>"
  }
}

Path Parameters

​
agent_id
string<uuid>
required

A UUID string identifying this base agent.

Query Parameters

​
organization_id
string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Body

Serializer for updating BaseAgent

​
name
string

New name for the agent. Must not be empty if provided.

Minimum string length: 1
​
disable_cache
boolean

Whether to disable job cache fetching for this agent.

​
cache_failed_jobs
boolean

Whether to cache failed jobs for this agent.

Response

Agent updated successfully.

Serializer for BaseAgent (agent config)

​
id
string<uuid>
required
​
created_at
string<date-time>
required
​
name
string
required
Required string length: 1 - 200
​
disable_cache
boolean
required

Whether to disable job cache fetching for this agent.

​
cache_failed_jobs
boolean
required

Whether to cache failed jobs for this agent.

​
organization_id
string<uuid>
required

Organization ID that owns this agent.

​
engine_class_id
string
required
Maximum string length: 200
​
current_version_id
string<uuid>
required

UUID of the current agent version.

​
job_count
integer
required
​
most_recent_job
string<date-time>
required
​
engine_name
string
required

Engine Display Name

​
tags
string
required
​
creator
object