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"
]
}Get detailed metadata, input fields, and output fields for a specific agent by its ID or slug.
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"
]
}Bearer token from your account (https://agent.ai/user/integrations#api)
The agent ID or human-readable slug (e.g. "fluximage" or "1a4g81x0bfsc5dpi").
"fluximage"
Agent details retrieved successfully
HTTP status code
200
Agent metadata and configuration details.
Show child attributes
List of input field variable names the agent accepts.
["image_prompt"]
List of output variable names the agent produces.
["image_generated"]