Paid agents API
The agents API from Paid — 3 operation(s) for agents.
The agents API from Paid — 3 operation(s) for agents.
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/paid-agents-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Reference Agents API
version: 1.0.0
servers:
- url: https://api.agentpaid.io/api/v1
description: Production
tags:
- name: agents
paths:
/agents:
get:
operationId: list
summary: List agents
description: 'DEPRECATED: Use /products instead. Agents are now products with type=''agent''.'
tags:
- agents
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Success response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Agent'
post:
operationId: create
summary: Create Agent
description: 'DEPRECATED: Use POST /products instead.'
tags:
- agents
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'201':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AgentCreate'
/agents/{agentId}:
get:
operationId: get
summary: Get agent by ID
description: 'DEPRECATED: Use GET /products/{productId} instead.'
tags:
- agents
parameters:
- name: agentId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
put:
operationId: update
summary: Update Agent
description: 'DEPRECATED: Use PUT /products/{productId} instead.'
tags:
- agents
parameters:
- name: agentId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AgentUpdate'
delete:
operationId: delete
summary: Delete agent
description: 'DEPRECATED: Use DELETE /products/{productId} instead.'
tags:
- agents
parameters:
- name: agentId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'204':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/agents_delete_Response_204'
/agents/external/{externalId}:
get:
operationId: get-by-external-id
summary: Get agent by external ID
description: 'DEPRECATED: Use GET /products/external/{externalId} instead.'
tags:
- agents
parameters:
- name: externalId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
put:
operationId: update-by-external-id
summary: Update agent by external ID
description: 'DEPRECATED: Use PUT /products/external/{externalId} instead.'
tags:
- agents
parameters:
- name: externalId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AgentUpdate'
delete:
operationId: delete-by-external-id
summary: Delete agent by external ID
description: 'DEPRECATED: Use DELETE /products/external/{externalId} instead.'
tags:
- agents
parameters:
- name: externalId
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'204':
description: Success response
content:
application/json:
schema:
$ref: '#/components/schemas/agents_deleteByExternalId_Response_204'
components:
schemas:
AgentUpdate:
type: object
properties:
name:
type: string
description:
type: string
externalId:
type: string
active:
type: boolean
agentCode:
type: string
agentAttributes:
type: array
items:
$ref: '#/components/schemas/AgentAttribute'
title: AgentUpdate
AgentCreate:
type: object
properties:
name:
type: string
description:
type: string
agentCode:
type: string
externalId:
type: string
active:
type: boolean
required:
- name
- description
title: AgentCreate
AgentPricePoint:
type: object
properties:
unitPrice:
type: number
format: double
minQuantity:
type: number
format: double
includedQuantity:
type: number
format: double
tiers:
type: array
items:
$ref: '#/components/schemas/AgentPricePointTiers'
title: AgentPricePoint
PricingModelType:
type: string
enum:
- PerUnit
- VolumePricing
- GraduatedPricing
- PrepaidCredits
title: PricingModelType
AgentPricePointTiers:
type: object
properties:
minQuantity:
type: number
format: double
maxQuantity:
type: number
format: double
unitPrice:
type: number
format: double
required:
- unitPrice
title: AgentPricePointTiers
AgentAttribute:
type: object
properties:
name:
type: string
active:
type: boolean
pricing:
$ref: '#/components/schemas/Pricing'
required:
- name
- active
- pricing
title: AgentAttribute
ChargeType:
type: string
enum:
- oneTime
- recurring
- usage
- seatBased
title: ChargeType
BillingFrequency:
type: string
enum:
- monthly
- quarterly
- annual
title: BillingFrequency
Pricing:
type: object
properties:
eventName:
type: string
taxable:
type: boolean
creditCost:
type: number
format: double
chargeType:
$ref: '#/components/schemas/ChargeType'
pricingModel:
$ref: '#/components/schemas/PricingModelType'
billingFrequency:
$ref: '#/components/schemas/BillingFrequency'
pricePoints:
type: object
additionalProperties:
$ref: '#/components/schemas/AgentPricePoint'
required:
- taxable
- chargeType
- pricingModel
- billingFrequency
- pricePoints
title: Pricing
agents_delete_Response_204:
type: object
properties: {}
description: Empty response body
title: agents_delete_Response_204
Agent:
type: object
properties:
id:
type: string
externalId:
type: string
organizationId:
type: string
name:
type: string
description:
type: string
active:
type: boolean
agentCode:
type: string
agentAttributes:
type: array
items:
$ref: '#/components/schemas/AgentAttribute'
required:
- id
- organizationId
- name
- active
title: Agent
agents_deleteByExternalId_Response_204:
type: object
properties: {}
description: Empty response body
title: agents_deleteByExternalId_Response_204
securitySchemes:
bearerAuth:
type: http
scheme: bearer