Skip to main content
POST
/
action
/
describe_agent
Describe Agent
curl --request POST \
  --url https://api-lr.agent.ai/v1/action/describe_agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "fluximage"
}
'
{
  "status": 200,
  "agent": {
    "id": "1a4g81x0bfsc5dpi",
    "human_id": "fluximage",
    "name": "Flux Image Generator",
    "description": "Generates an image using the new Flux AI model.",
    "url": "https://agent.ai/agent/fluximage",
    "profile_url": "https://agent.ai/profile/fluximage",
    "icon": "/icons/generative-image.svg",
    "type": "studio",
    "status": "public",
    "tags": [
      "Marketing"
    ],
    "executions": 970429,
    "review": {
      "count": 26611,
      "score": 4.23
    },
    "authors": [
      {
        "name": "Dharmesh Shah",
        "username": "dharmesh",
        "user_token": "77cadf7cbd19448b9f11951082c26bd1"
      }
    ],
    "created_at": "2024-08-15T20:56:33",
    "updated_at": "2026-03-13T17:44:27"
  },
  "inputs": [
    "image_prompt"
  ],
  "outputs": [
    "image_generated"
  ]
}

Authorizations

Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/integrations#api)

Body

application/json
agent_id
string
required

The agent ID or human-readable slug (e.g. "fluximage" or "1a4g81x0bfsc5dpi").

Example:

"fluximage"

Response

Agent details retrieved successfully

status
integer

HTTP status code

Example:

200

agent
object

Agent metadata and configuration details.

inputs
string[]

List of input field variable names the agent accepts.

Example:
["image_prompt"]
outputs
string[]

List of output variable names the agent produces.

Example:
["image_generated"]