find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/agentry-com:agentry-com-invoke-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Agentry Invoke API
  description: AI Agent Registry and Discovery service — browse, search, and register AI agents. Machine-readable via /llms.txt, /.well-known/agents.json, and /api/agents/public (A2A).
  version: 0.4.0
tags:
- name: invoke
paths:
  /api/invoke/budget:
    post:
      tags:
      - invoke
      summary: Set Budget
      description: Set budget controls for a calling agent. Requires admin key.
      operationId: set_budget_api_invoke_budget_post
      parameters:
      - name: X-Admin-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Admin-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BudgetControlRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Set Budget Api Invoke Budget Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/budget/{agent_id}:
    get:
      tags:
      - invoke
      summary: Get Budget
      description: Return current budget controls for an agent.
      operationId: get_budget_api_invoke_budget__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Budget Api Invoke Budget  Agent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/budget/{agent_id}/spending:
    get:
      tags:
      - invoke
      summary: Get Spending
      description: Return current spending against limits for an agent.
      operationId: get_spending_api_invoke_budget__agent_id__spending_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Spending Api Invoke Budget  Agent Id  Spending Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/history:
    get:
      tags:
      - invoke
      summary: List Invocations
      description: Return invocation history, optionally filtered by caller or target agent.
      operationId: list_invocations_api_invoke_history_get
      parameters:
      - name: caller_agent_id
        in: query
        required: false
        schema:
          type: string
          description: Filter by caller agent ID
          title: Caller Agent Id
        description: Filter by caller agent ID
      - name: target_agent_id
        in: query
        required: false
        schema:
          type: string
          description: Filter by target agent ID
          title: Target Agent Id
        description: Filter by target agent ID
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Invocations Api Invoke History Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/history/{invocation_id}:
    get:
      tags:
      - invoke
      summary: Get Invocation
      description: Return a single invocation record by ID.
      operationId: get_invocation_api_invoke_history__invocation_id__get
      parameters:
      - name: invocation_id
        in: path
        required: true
        schema:
          type: string
          title: Invocation Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Invocation Api Invoke History  Invocation Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/schema/{agent_id}:
    post:
      tags:
      - invoke
      summary: Register Capability Schema
      description: Register or update a capability schema for an agent. Requires admin key.
      operationId: register_capability_schema_api_invoke_schema__agent_id__post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: X-Admin-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Admin-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CapabilitySchemaRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Register Capability Schema Api Invoke Schema  Agent Id  Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - invoke
      summary: Get Capability Schema
      description: 'Return the capability schema for an agent. Public endpoint.


        If no schema is registered, attempts to auto-generate one from the

        agent''s A2A card skills (fetched from card_url if available).'
      operationId: get_capability_schema_api_invoke_schema__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Capability Schema Api Invoke Schema  Agent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/invoke/{agent_id}:
    post:
      tags:
      - invoke
      summary: Invoke Agent
      description: 'Proxy an invocation to a target agent through Agentry.


        Flow:

        1. Validate target agent exists and has the requested capability

        2. Check budget controls for the caller

        3. Build the full URL and forward the request via httpx

        4. Create escrow micro-contract if capability has pricing

        5. Record invocation history and reputation events

        6. Return result with metadata'
      operationId: invoke_agent_api_invoke__agent_id__post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvocationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Invoke Agent Api Invoke  Agent Id  Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CapabilitySchemaRequest:
      properties:
        capabilities:
          items:
            $ref: '#/components/schemas/CapabilityDef'
          type: array
          minItems: 1
          title: Capabilities
          description: List of capability definitions
      type: object
      required:
      - capabilities
      title: CapabilitySchemaRequest
    CapabilityDef:
      properties:
        id:
          type: string
          title: Id
          description: Unique capability identifier, e.g. 'search-documents'
        name:
          type: string
          title: Name
          description: Human-readable name
        description:
          type: string
          title: Description
          description: What this capability does
          default: ''
        endpoint:
          type: string
          title: Endpoint
          description: Path on the agent's server, e.g. '/api/search'
        method:
          type: string
          title: Method
          description: HTTP method (GET, POST, etc.)
          default: POST
        inputs:
          additionalProperties: true
          type: object
          title: Inputs
          description: Input parameter definitions
        outputs:
          additionalProperties: true
          type: object
          title: Outputs
          description: Output field definitions
        pricing:
          additionalProperties: true
          type: object
          title: Pricing
          description: 'Pricing info, e.g. {''per_request_sats'': 10}'
      type: object
      required:
      - id
      - name
      - endpoint
      title: CapabilityDef
    InvocationRequest:
      properties:
        capability:
          type: string
          title: Capability
          description: Capability ID to invoke, e.g. 'search-documents'
        input:
          additionalProperties: true
          type: object
          title: Input
          description: Input payload for the capability
        caller_agent_id:
          type: string
          title: Caller Agent Id
          description: Agent ID of the caller
        budget_sats:
          anyOf:
          - type: integer
          - type: 'null'
          title: Budget Sats
          description: Max sats the caller is willing to spend
        callback_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Callback Url
          description: Optional webhook for async results
        timeout_seconds:
          type: integer
          maximum: 120.0
          minimum: 1.0
          title: Timeout Seconds
          description: Request timeout in seconds
          default: 30
      type: object
      required:
      - capability
      - caller_agent_id
      title: InvocationRequest
    BudgetControlRequest:
      properties:
        agent_id:
          type: string
          title: Agent Id
          description: Agent ID to set budget controls for
        max_per_invocation_sats:
          type: integer
          minimum: 0.0
          title: Max Per Invocation Sats
          default: 1000
        max_per_day_sats:
          type: integer
          minimum: 0.0
          title: Max Per Day Sats
          default: 10000
        max_per_month_sats:
          type: integer
          minimum: 0.0
          title: Max Per Month Sats
          default: 100000
        whitelist_agents:
          items:
            type: string
          type: array
          title: Whitelist Agents
          description: Only allow calls to these agents (empty = allow all)
        blacklist_agents:
          items:
            type: string
          type: array
          title: Blacklist Agents
          description: Block calls to these agents
        require_approval_above_sats:
          type: integer
          minimum: 0.0
          title: Require Approval Above Sats
          description: Require approval for invocations above this cost
          default: 500
        enabled:
          type: boolean
          title: Enabled
          default: true
      type: object
      required:
      - agent_id
      title: BudgetControlRequest