inference-sh

inference-sh Agents API

The agents API from inference-sh — 45 operation(s) for agents.

GitHub OpenAPI

Operations 50

GET /agents Get agents #
POST /agents Create agents #
GET /agents/hook-events Get agents hook events #
GET /agents/internal-tools Get agents internal tools #
POST /agents/list Create agents list #
POST /agents/message Create agents message #
POST /agents/messages Create agents messages #
POST /agents/run Create agents run #
DELETE /agents/{id} Delete agents by id #
GET /agents/{id} Get agents by id #
POST /agents/{id} Create agents by id #
POST /agents/{id}/a2a/ Create agents by id a2a #
POST /agents/{id}/a2a/message:send Create agents by id a2a message:send #
POST /agents/{id}/a2a/message:stream Create agents by id a2a message:stream #
GET /agents/{id}/a2a/tasks Get agents by id a2a tasks #
GET /agents/{id}/a2a/tasks/{runID} Get agents by id a2a tasks by run id #
POST /agents/{id}/a2a/tasks/{runID}:cancel Create agents by id a2a tasks {run id}:cancel #
GET /agents/{id}/a2a/tasks/{runID}:subscribe Get agents by id a2a tasks {run id}:subscribe #
GET /agents/{id}/card Get agents by id card #
POST /agents/{id}/channel/{provider} Create agents by id channel by provider #
POST /agents/{id}/duplicate Create agents by id duplicate #
POST /agents/{id}/move Create agents by id move #
DELETE /agents/{id}/org-share Delete agents by id org share #
GET /agents/{id}/rules Get agents by id rules #
POST /agents/{id}/rules Create agents by id rules #
POST /agents/{id}/rules/explain Create agents by id rules explain #
POST /agents/{id}/rules/preview Create agents by id rules preview #
GET /agents/{id}/rules/recent Get agents by id rules recent #
DELETE /agents/{id}/rules/{ruleId} Delete agents by id rules by rule id #
PUT /agents/{id}/rules/{ruleId} Replace agents by id rules by rule id #
POST /agents/{id}/share Create agents by id share #
DELETE /agents/{id}/share/{userId} Delete agents by id share by user id #
GET /agents/{id}/shares Get agents by id shares #
POST /agents/{id}/slack Create agents by id slack #
DELETE /agents/{id}/team-share Delete agents by id team share #
POST /agents/{id}/transfer Create agents by id transfer #
GET /agents/{id}/versions Get agents by id versions #
POST /agents/{id}/versions/list Create agents by id versions list #
GET /agents/{id}/versions/{versionId} Get agents by id versions by version id #
POST /agents/{id}/visibility Create agents by id visibility #
GET /agents/{namespace}/{name} Get agents by namespace by name #
POST /agents/{namespace}/{name}/a2a/ Create agents by namespace by name a2a #
POST /agents/{namespace}/{name}/a2a/message:send Create agents by namespace by name a2a message:send #
POST /agents/{namespace}/{name}/a2a/message:stream Create agents by namespace by name a2a message:stream #
GET /agents/{namespace}/{name}/a2a/tasks Get agents by namespace by name a2a tasks #
GET /agents/{namespace}/{name}/a2a/tasks/{runID} Get agents by namespace by name a2a tasks by run id #
POST /agents/{namespace}/{name}/a2a/tasks/{runID}:cancel Create agents by namespace by name a2a tasks {run id}:cancel #
GET /agents/{namespace}/{name}/a2a/tasks/{runID}:subscribe Get agents by namespace by name a2a tasks {run id}:subscribe #
GET /agents/{namespace}/{name}/card Get agents by namespace by name card #
POST /agents/{namespace}/{name}/openai/chat/completions Create agents by namespace by name openai chat completions #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/inference-sh/openapi/inference-sh-agents-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/inference-sh:inference-sh-agents-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

inference-sh-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: inference.sh Agents API
  version: '2'
servers:
- url: https://api.inference.sh
tags:
- name: Agents
paths:
  /agents:
    get:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Get agents
      x-summary-source: derived
      operationId: getAgents
      x-operation-id-source: derived
    post:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Create agents
      x-summary-source: derived
      operationId: postAgents
      x-operation-id-source: derived
  /agents/hook-events:
    get:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Get agents hook events
      x-summary-source: derived
      operationId: getAgentsHookEvents
      x-operation-id-source: derived
  /agents/internal-tools:
    get:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Get agents internal tools
      x-summary-source: derived
      operationId: getAgentsInternalTools
      x-operation-id-source: derived
  /agents/list:
    post:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Create agents list
      x-summary-source: derived
      operationId: postAgentsList
      x-operation-id-source: derived
  /agents/message:
    post:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Create agents message
      x-summary-source: derived
      operationId: postAgentsMessage
      x-operation-id-source: derived
  /agents/messages:
    post:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Create agents messages
      x-summary-source: derived
      operationId: postAgentsMessages
      x-operation-id-source: derived
  /agents/run:
    post:
      tags:
      - Agents
      responses:
        '200':
          description: Success
      summary: Create agents run
      x-summary-source: derived
      operationId: postAgentsRun
      x-operation-id-source: derived
  /agents/{id}:
    delete:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete agents by id
      x-summary-source: derived
      operationId: deleteAgentsById
      x-operation-id-source: derived
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id
      x-summary-source: derived
      operationId: getAgentsById
      x-operation-id-source: derived
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id
      x-summary-source: derived
      operationId: postAgentsById
      x-operation-id-source: derived
  /agents/{id}/a2a/:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id a2a
      x-summary-source: derived
      operationId: postAgentsByIdA2a
      x-operation-id-source: derived
  /agents/{id}/a2a/message:send:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id a2a message:send
      x-summary-source: derived
      operationId: postAgentsByIdA2aMessage:send
      x-operation-id-source: derived
  /agents/{id}/a2a/message:stream:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id a2a message:stream
      x-summary-source: derived
      operationId: postAgentsByIdA2aMessage:stream
      x-operation-id-source: derived
  /agents/{id}/a2a/tasks:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id a2a tasks
      x-summary-source: derived
      operationId: getAgentsByIdA2aTasks
      x-operation-id-source: derived
  /agents/{id}/a2a/tasks/{runID}:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: runID
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id a2a tasks by run id
      x-summary-source: derived
      operationId: getAgentsByIdA2aTasksByRunID
      x-operation-id-source: derived
  /agents/{id}/a2a/tasks/{runID}:cancel:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id a2a tasks {run id}:cancel
      x-summary-source: derived
      operationId: postAgentsByIdA2aTasks{runID}:cancel
      x-operation-id-source: derived
  /agents/{id}/a2a/tasks/{runID}:subscribe:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id a2a tasks {run id}:subscribe
      x-summary-source: derived
      operationId: getAgentsByIdA2aTasks{runID}:subscribe
      x-operation-id-source: derived
  /agents/{id}/card:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id card
      x-summary-source: derived
      operationId: getAgentsByIdCard
      x-operation-id-source: derived
  /agents/{id}/channel/{provider}:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: provider
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id channel by provider
      x-summary-source: derived
      operationId: postAgentsByIdChannelByProvider
      x-operation-id-source: derived
  /agents/{id}/duplicate:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id duplicate
      x-summary-source: derived
      operationId: postAgentsByIdDuplicate
      x-operation-id-source: derived
  /agents/{id}/move:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id move
      x-summary-source: derived
      operationId: postAgentsByIdMove
      x-operation-id-source: derived
  /agents/{id}/org-share:
    delete:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete agents by id org share
      x-summary-source: derived
      operationId: deleteAgentsByIdOrgShare
      x-operation-id-source: derived
  /agents/{id}/rules:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id rules
      x-summary-source: derived
      operationId: getAgentsByIdRules
      x-operation-id-source: derived
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id rules
      x-summary-source: derived
      operationId: postAgentsByIdRules
      x-operation-id-source: derived
  /agents/{id}/rules/explain:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id rules explain
      x-summary-source: derived
      operationId: postAgentsByIdRulesExplain
      x-operation-id-source: derived
  /agents/{id}/rules/preview:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id rules preview
      x-summary-source: derived
      operationId: postAgentsByIdRulesPreview
      x-operation-id-source: derived
  /agents/{id}/rules/recent:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id rules recent
      x-summary-source: derived
      operationId: getAgentsByIdRulesRecent
      x-operation-id-source: derived
  /agents/{id}/rules/{ruleId}:
    delete:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: ruleId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete agents by id rules by rule id
      x-summary-source: derived
      operationId: deleteAgentsByIdRulesByRuleId
      x-operation-id-source: derived
    put:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: ruleId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Replace agents by id rules by rule id
      x-summary-source: derived
      operationId: putAgentsByIdRulesByRuleId
      x-operation-id-source: derived
  /agents/{id}/share:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id share
      x-summary-source: derived
      operationId: postAgentsByIdShare
      x-operation-id-source: derived
  /agents/{id}/share/{userId}:
    delete:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: userId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete agents by id share by user id
      x-summary-source: derived
      operationId: deleteAgentsByIdShareByUserId
      x-operation-id-source: derived
  /agents/{id}/shares:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id shares
      x-summary-source: derived
      operationId: getAgentsByIdShares
      x-operation-id-source: derived
  /agents/{id}/slack:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id slack
      x-summary-source: derived
      operationId: postAgentsByIdSlack
      x-operation-id-source: derived
  /agents/{id}/team-share:
    delete:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete agents by id team share
      x-summary-source: derived
      operationId: deleteAgentsByIdTeamShare
      x-operation-id-source: derived
  /agents/{id}/transfer:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id transfer
      x-summary-source: derived
      operationId: postAgentsByIdTransfer
      x-operation-id-source: derived
  /agents/{id}/versions:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id versions
      x-summary-source: derived
      operationId: getAgentsByIdVersions
      x-operation-id-source: derived
  /agents/{id}/versions/list:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id versions list
      x-summary-source: derived
      operationId: postAgentsByIdVersionsList
      x-operation-id-source: derived
  /agents/{id}/versions/{versionId}:
    get:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: versionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by id versions by version id
      x-summary-source: derived
      operationId: getAgentsByIdVersionsByVersionId
      x-operation-id-source: derived
  /agents/{id}/visibility:
    post:
      tags:
      - Agents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by id visibility
      x-summary-source: derived
      operationId: postAgentsByIdVisibility
      x-operation-id-source: derived
  /agents/{namespace}/{name}:
    get:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by namespace by name
      x-summary-source: derived
      operationId: getAgentsByNamespaceByName
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/:
    post:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by namespace by name a2a
      x-summary-source: derived
      operationId: postAgentsByNamespaceByNameA2a
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/message:send:
    post:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by namespace by name a2a message:send
      x-summary-source: derived
      operationId: postAgentsByNamespaceByNameA2aMessage:send
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/message:stream:
    post:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by namespace by name a2a message:stream
      x-summary-source: derived
      operationId: postAgentsByNamespaceByNameA2aMessage:stream
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/tasks:
    get:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by namespace by name a2a tasks
      x-summary-source: derived
      operationId: getAgentsByNamespaceByNameA2aTasks
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/tasks/{runID}:
    get:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      - name: runID
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by namespace by name a2a tasks by run id
      x-summary-source: derived
      operationId: getAgentsByNamespaceByNameA2aTasksByRunID
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/tasks/{runID}:cancel:
    post:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by namespace by name a2a tasks {run id}:cancel
      x-summary-source: derived
      operationId: postAgentsByNamespaceByNameA2aTasks{runID}:cancel
      x-operation-id-source: derived
  /agents/{namespace}/{name}/a2a/tasks/{runID}:subscribe:
    get:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by namespace by name a2a tasks {run id}:subscribe
      x-summary-source: derived
      operationId: getAgentsByNamespaceByNameA2aTasks{runID}:subscribe
      x-operation-id-source: derived
  /agents/{namespace}/{name}/card:
    get:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get agents by namespace by name card
      x-summary-source: derived
      operationId: getAgentsByNamespaceByNameCard
      x-operation-id-source: derived
  /agents/{namespace}/{name}/openai/chat/completions:
    post:
      tags:
      - Agents
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create agents by namespace by name openai chat completions
      x-summary-source: derived
      operationId: postAgentsByNamespaceByNameOpenaiChatCompletions
      x-operation-id-source: derived