Skip to main content
PUT
/
agent
/
{id}
Update Agent
curl --request PUT \
  --url https://{api-address}.org.machina.gg/agent/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "status": "active",
  "context": {},
  "workflows": "<array>"
}
'
{
  "message": "agent updated",
  "status": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.machina.gg/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-token
string
header
required

API key authentication

Path Parameters

​
id
string
required

Unique ID of the agent to update

Body

application/json
​
title
string

Updated display title of the agent

​
description
string

Updated description of the agent's purpose

​
status
enum<string>

Updated status of the agent

Available options:
active,
inactive
​
context
object

Updated configuration settings for the agent

​
workflows
array

Updated list of workflows associated with the agent

Response

Agent updated successfully

​
message
string

Success message

Example:

"agent updated"

​
status
boolean

Operation status

Example:

true