Skip to main content
GET
/
ai-agents
List AI Agents
curl --request GET \
  --url https://use.hoop.dev/api/ai-agents
[
  {
    "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"
  }
]

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