APapinizer
ApiProxy

Create an A2A API Proxy

Changed on

Permission: API_MANAGEMENT or AI_DEVELOPMENT × MANAGE. Creates a name-based A2A (Agent-to-Agent) API Proxy in a single call. The path apiProxyName overrides the body name. routingMode defaults to AGENT_EXPOSE when omitted (PASSTHROUGH is also accepted). protocolVersion is optional. For PASSTHROUGH the backend target is given inline via a2aRouting.backendServers[] (each entry needs a non-blank endpoint); referencing a separate connection is no longer supported. For AGENT_EXPOSE an empty aiRouting is seeded automatically (required by validation) — configure it afterward via ai-routing/.

post/apiops/projects/{projectName}/apiProxies/a2a/{apiProxyName}/

Request

Path parameters

projectNamestring required

Project name

apiProxyNamestring required

A2A API Proxy name (overrides body name)

Request body

relativePathstring
descriptionstring
routingMode'AGENT_EXPOSE' | 'PASSTHROUGH'
protocolVersionstring

Response

successful operation!

status'SUCCESS' | 'FAILURE'
resultMessagestring
resultListstring[]
resultCountinteger
unresolvedReferencesstring[]

Changes

  • d1a546deccf0Revision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      the request property type changed from object to string

    • warning

      removed the request property

    This list may be incomplete.

  • 9ae232e55479Revision changes
    • info

      endpoint added