Interface AgentAPIAttributes

It describes the API exposed by an AI Agent. This information is necessary to query the AI Agent and to know which endpoints are available.

interface AgentAPIAttributes {
    agentDefinitionUrl: string;
    authType?: "none" | "basic" | "oauth" | "bearer";
    endpoints: Endpoint[];
    openEndpoints?: string[];
    password?: string;
    token?: string;
    username?: string;
}

Properties

agentDefinitionUrl: string

The URL to the agent definition. Can be an OpenAPI spec, MCP Manifest, or A2A agent card. This field is mandatory and defines how the agent/service can be discovered and queried.

authType?: "none" | "basic" | "oauth" | "bearer"

The upstream agent/service authentication type ('none', 'basic', 'bearer' or 'oauth').

endpoints: Endpoint[]

The list endpoints of the upstream service. All these endpoints are protected and only accessible to subscribers of the Payment Plan.

openEndpoints?: string[]

The list of endpoints of the upstream service that publicly available. The access to these endpoints don't require subscription to the Payment Plan. They are useful to expose documentation, etc.

password?: string

The upstream agent/service password for authentication. Only if authType is 'basic'.

token?: string

The upstream agent/service bearer token for authentication. Only if authType is 'bearer' or 'oauth'.

username?: string

The upstream agent/service username for authentication. Only if authType is 'basic'.