Skip to main content
PUT
/
ai-agents
/
{nameOrID}
Update AI Agent
curl --request PUT \
  --url https://use.hoop.dev/api/ai-agents/{nameOrID} \
  --header 'Content-Type: application/json' \
  --data '
{
  "groups": [
    "engineering",
    "platform"
  ],
  "name": "claude-prod"
}
'
{
  "created_at": "<string>",
  "created_by": "<string>",
  "deactivated_at": "<string>",
  "deactivated_by": "<string>",
  "groups": [
    "engineering"
  ],
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "last_used_at": "<string>",
  "masked_key": "hpk_1nzb***************************************",
  "name": "ai-agent",
  "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Path Parameters

​
nameOrID
string
required

Name or UUID of the AI Agent

Body

application/json

The request body resource

​
groups
string[]

Updated group list (replaces existing groups)

Example:
["engineering", "platform"]
​
name
string

Updated display name

Example:

"claude-prod"

Response

OK

​
created_at
string

Creation timestamp

​
created_by
string

Subject of the admin who created this agent

​
deactivated_at
string

Revocation timestamp

​
deactivated_by
string

Subject of the admin who revoked this agent

​
groups
string[]

Groups assigned to this AI Agent

Example:
["engineering"]
​
id
string<uuid>
read-only

Unique identifier

​
last_used_at
string

Timestamp of last usage

​
masked_key
string

Masked version of the AI Agent key for identification

Example:

"hpk_1nzb***************************************"

​
name
string

Human-readable name

Example:

"ai-agent"

​
org_id
string<uuid>
read-only

Organization ID

​
status
enum<string>

Current status of the AI Agent

Available options:
active,
revoked