agentry-com Invoke API
The invoke API from agentry-com — 7 operation(s) for invoke.
The invoke API from agentry-com — 7 operation(s) for invoke.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/agentry-com:agentry-com-invoke-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
A second provider on the same verified email joins the account you already have.
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