Skip to main content
PUT
/
accounts
/
agent
/
{agentId}
Update details for a specific AI agent
curl --request PUT \
  --url https://server.ownid.com/{appId}/accounts/agent/{agentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "suspended",
  "agentType": "custom-ai",
  "metadata": {
    "notes": "Updated due to new security policy."
  }
}
'
{
  "agentId": "agent_12345",
  "agentType": "custom-ai",
  "status": "suspended",
  "metadata": {
    "notes": "Updated due to new security policy."
  },
  "updatedAt": "2025-02-15T12:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Authorization
string
required

Bearer Token for admin authorization

Path Parameters

​
agentId
string
required

Unique identifier for the AI agent

Body

application/json
​
status
string

The new status for the AI agent

Example:

"suspended"

​
agentType
string

(Optional) Update the agent type if necessary

Example:

"custom-ai"

​
metadata
object

Additional metadata or information about the agent

Example:
{
  "notes": "Updated due to new security policy."
}

Response

Successful update of agent data

​
agentId
string

The unique identifier for the AI agent

Example:

"agent_12345"

​
agentType
string

The type of agent

Example:

"custom-ai"

​
status
string

Current status of the AI agent

Example:

"suspended"

​
metadata
object

Updated metadata about the agent

Example:
{
  "notes": "Updated due to new security policy."
}
​
updatedAt
string<date-time>

Date and time the agent was last updated

Example:

"2025-02-15T12:00:00.000Z"