latestOpenAPI 3.1.02026-08-197104501.1 MB

8fbaab4fc7c5

[beta] A2A Agents

Create Agent

Create a new agent

Example Request:

curl -X POST "http://localhost:4000/agents" \
    -H "Authorization: Bearer <your_api_key>" \
    -H "Content-Type: application/json" \
    -d '{
        "agent": {
            "agent_name": "my-custom-agent",
            "agent_card_params": {
                "protocolVersion": "1.0",
                "name": "Hello World Agent",
                "description": "Just a hello world agent",
                "url": "http://localhost:9999/",
                "version": "1.0.0",
                "defaultInputModes": ["text"],
                "defaultOutputModes": ["text"],
                "capabilities": {
                    "streaming": true
                },
                "skills": [
                    {
                        "id": "hello_world",
                        "name": "Returns hello world",
                        "description": "just returns hello world",
                        "tags": ["hello world"],
                        "examples": ["hi", "hello world"]
                    }
                ]
            },
            "litellm_params": {
                "make_public": true
            }
        }
    }'
post/v1/agents

Request body

agent_namestring required
litellm_paramsobject
tpm_limitinteger nullable
rpm_limitinteger nullable
session_tpm_limitinteger nullable
session_rpm_limitinteger nullable
static_headersobject nullable
extra_headersstring[] nullable

Response

Successful Response

agent_idstring required
agent_namestring required
litellm_paramsobject nullable
agent_card_paramsobject required
object_permissionobject nullable
spendnumber nullable
tpm_limitinteger nullable
rpm_limitinteger nullable
session_tpm_limitinteger nullable
session_rpm_limitinteger nullable
static_headersobject nullable
extra_headersstring[] nullable
created_atstring date-time nullable
updated_atstring date-time nullable
created_bystring nullable
updated_bystring nullable