Agent Management

Register Agent

Register a new A2A agent in the registry.

Requires publish_agent scope/permission.

Args: request: Agent registration request data user_context: Authenticated user context

Returns: 201 with agent card and registration metadata

Raises: HTTPException: 409 if path exists, 422 if validation fails, 403 if unauthorized

post/api/agents/register

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Request body

namestring required

Agent name

descriptionstring

Agent description

urlstring required

Agent endpoint URL

pathstring nullable

Registry path (optional - auto-generated if not provided)

protocolVersionstring

A2A protocol version

versionstring nullable

Agent version

providerobject nullable

Agent provider information {organization, url}

securitySchemesobject nullable

Security schemes configuration

skillsobject[] nullable

Agent skills

streamingboolean

Supports streaming responses

licensestring

License information

visibilitystring

Visibility: public, private, or group-restricted

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 4 revisions of this API.