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

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

Successful Response

{"stackTrail":"paths:/api/agents/register:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}