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

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