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

Body

application/json

The request body resource

​
name
string
required

Human-readable name for the AI Agent

Example:

"claude-ops"

​
groups
string[]

Groups to assign to this AI Agent

Example:
["engineering"]

Response

Created

​
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

​
key
string

The generated AI Agent key. This is the only time the full key is shown.

Example:

"hpk_Ab3fX9kL..."

​
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