inference-sh Chats API

The chats API from inference-sh — 27 operation(s) for chats.

Operations 46

GET /chats Get chats #
POST /chats Create chats #
POST /chats/list Create chats list #
DELETE /chats/messages/{id}/stream Delete chats messages by id stream #
GET /chats/messages/{id}/stream Get chats messages by id stream #
HEAD /chats/messages/{id}/stream Check chats messages by id stream #
OPTIONS /chats/messages/{id}/stream Describe chats messages by id stream #
PATCH /chats/messages/{id}/stream Update chats messages by id stream #
POST /chats/messages/{id}/stream Create chats messages by id stream #
PUT /chats/messages/{id}/stream Replace chats messages by id stream #
POST /chats/messages/{messageId}/cancel Create chats messages by message id cancel #
POST /chats/{chatId}/settings Create chats by chat id settings #
POST /chats/{chatId}/tools/{toolId}/always-allow Create chats by chat id tools by tool id always allow #
GET /chats/{chatId}/tools/{toolId}/always-allow/options Get chats by chat id tools by tool id always allow options #
POST /chats/{chatId}/tools/{toolId}/explain Create chats by chat id tools by tool id explain #
DELETE /chats/{id} Delete chats by id #
GET /chats/{id} Get chats by id #
PATCH /chats/{id} Update chats by id #
POST /chats/{id} Create chats by id #
POST /chats/{id}/agent Create chats by id agent #
GET /chats/{id}/messages Get chats by id messages #
POST /chats/{id}/messages Create chats by id messages #
POST /chats/{id}/messages/list Create chats by id messages list #
POST /chats/{id}/project Create chats by id project #
GET /chats/{id}/rules Get chats by id rules #
POST /chats/{id}/rules Create chats by id rules #
POST /chats/{id}/rules/explain Create chats by id rules explain #
POST /chats/{id}/rules/preview Create chats by id rules preview #
GET /chats/{id}/rules/recent Get chats by id rules recent #
DELETE /chats/{id}/rules/{ruleId} Delete chats by id rules by rule id #
PUT /chats/{id}/rules/{ruleId} Replace chats by id rules by rule id #
GET /chats/{id}/status Get chats by id status #
POST /chats/{id}/steer Create chats by id steer #
POST /chats/{id}/stop Create chats by id stop #
DELETE /chats/{id}/stream Delete chats by id stream #
GET /chats/{id}/stream Get chats by id stream #
HEAD /chats/{id}/stream Check chats by id stream #
OPTIONS /chats/{id}/stream Describe chats by id stream #
PATCH /chats/{id}/stream Update chats by id stream #
POST /chats/{id}/stream Create chats by id stream #
PUT /chats/{id}/stream Replace chats by id stream #
GET /chats/{id}/trace Get chats by id trace #
POST /tools/{toolId} Create tools by tool id #
POST /tools/{toolId}/invoke Create tools by tool id invoke #
POST /tools/{toolId}/reject Create tools by tool id reject #
POST /tools/{toolId}/widget Create tools by tool id widget #

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-chats-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.

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

OpenAPI Specification

inference-sh-chats-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: inference.sh Chats API
  version: '2'
servers:
- url: https://api.inference.sh
tags:
- name: Chats
paths:
  /chats:
    get:
      tags:
      - Chats
      responses:
        '200':
          description: Success
      summary: Get chats
      x-summary-source: derived
      operationId: getChats
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      responses:
        '200':
          description: Success
      summary: Create chats
      x-summary-source: derived
      operationId: postChats
      x-operation-id-source: derived
  /chats/list:
    post:
      tags:
      - Chats
      responses:
        '200':
          description: Success
      summary: Create chats list
      x-summary-source: derived
      operationId: postChatsList
      x-operation-id-source: derived
  /chats/messages/{id}/stream:
    connect:
      tags:
      - chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
    query:
      tags:
      - chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
    delete:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete chats messages by id stream
      x-summary-source: derived
      operationId: deleteChatsMessagesByIdStream
      x-operation-id-source: derived
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats messages by id stream
      x-summary-source: derived
      operationId: getChatsMessagesByIdStream
      x-operation-id-source: derived
    head:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Check chats messages by id stream
      x-summary-source: derived
      operationId: headChatsMessagesByIdStream
      x-operation-id-source: derived
    options:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Describe chats messages by id stream
      x-summary-source: derived
      operationId: optionsChatsMessagesByIdStream
      x-operation-id-source: derived
    patch:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Update chats messages by id stream
      x-summary-source: derived
      operationId: patchChatsMessagesByIdStream
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats messages by id stream
      x-summary-source: derived
      operationId: postChatsMessagesByIdStream
      x-operation-id-source: derived
    put:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Replace chats messages by id stream
      x-summary-source: derived
      operationId: putChatsMessagesByIdStream
      x-operation-id-source: derived
    trace:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Trace chats messages by id stream
      x-summary-source: derived
      operationId: traceChatsMessagesByIdStream
      x-operation-id-source: derived
  /chats/messages/{messageId}/cancel:
    post:
      tags:
      - Chats
      parameters:
      - name: messageId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats messages by message id cancel
      x-summary-source: derived
      operationId: postChatsMessagesByMessageIdCancel
      x-operation-id-source: derived
  /chats/{chatId}/settings:
    post:
      tags:
      - Chats
      parameters:
      - name: chatId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by chat id settings
      x-summary-source: derived
      operationId: postChatsByChatIdSettings
      x-operation-id-source: derived
  /chats/{chatId}/tools/{toolId}/always-allow:
    post:
      tags:
      - Chats
      parameters:
      - name: chatId
        in: path
        required: true
        schema:
          type: string
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by chat id tools by tool id always allow
      x-summary-source: derived
      operationId: postChatsByChatIdToolsByToolIdAlwaysAllow
      x-operation-id-source: derived
  /chats/{chatId}/tools/{toolId}/always-allow/options:
    get:
      tags:
      - Chats
      parameters:
      - name: chatId
        in: path
        required: true
        schema:
          type: string
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by chat id tools by tool id always allow options
      x-summary-source: derived
      operationId: getChatsByChatIdToolsByToolIdAlwaysAllowOptions
      x-operation-id-source: derived
  /chats/{chatId}/tools/{toolId}/explain:
    post:
      tags:
      - Chats
      parameters:
      - name: chatId
        in: path
        required: true
        schema:
          type: string
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by chat id tools by tool id explain
      x-summary-source: derived
      operationId: postChatsByChatIdToolsByToolIdExplain
      x-operation-id-source: derived
  /chats/{id}:
    delete:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete chats by id
      x-summary-source: derived
      operationId: deleteChatsById
      x-operation-id-source: derived
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id
      x-summary-source: derived
      operationId: getChatsById
      x-operation-id-source: derived
    patch:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Update chats by id
      x-summary-source: derived
      operationId: patchChatsById
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id
      x-summary-source: derived
      operationId: postChatsById
      x-operation-id-source: derived
  /chats/{id}/agent:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id agent
      x-summary-source: derived
      operationId: postChatsByIdAgent
      x-operation-id-source: derived
  /chats/{id}/messages:
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id messages
      x-summary-source: derived
      operationId: getChatsByIdMessages
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id messages
      x-summary-source: derived
      operationId: postChatsByIdMessages
      x-operation-id-source: derived
  /chats/{id}/messages/list:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id messages list
      x-summary-source: derived
      operationId: postChatsByIdMessagesList
      x-operation-id-source: derived
  /chats/{id}/project:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id project
      x-summary-source: derived
      operationId: postChatsByIdProject
      x-operation-id-source: derived
  /chats/{id}/rules:
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id rules
      x-summary-source: derived
      operationId: getChatsByIdRules
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id rules
      x-summary-source: derived
      operationId: postChatsByIdRules
      x-operation-id-source: derived
  /chats/{id}/rules/explain:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id rules explain
      x-summary-source: derived
      operationId: postChatsByIdRulesExplain
      x-operation-id-source: derived
  /chats/{id}/rules/preview:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id rules preview
      x-summary-source: derived
      operationId: postChatsByIdRulesPreview
      x-operation-id-source: derived
  /chats/{id}/rules/recent:
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id rules recent
      x-summary-source: derived
      operationId: getChatsByIdRulesRecent
      x-operation-id-source: derived
  /chats/{id}/rules/{ruleId}:
    delete:
      tags:
      - Chats
      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 chats by id rules by rule id
      x-summary-source: derived
      operationId: deleteChatsByIdRulesByRuleId
      x-operation-id-source: derived
    put:
      tags:
      - Chats
      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 chats by id rules by rule id
      x-summary-source: derived
      operationId: putChatsByIdRulesByRuleId
      x-operation-id-source: derived
  /chats/{id}/status:
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id status
      x-summary-source: derived
      operationId: getChatsByIdStatus
      x-operation-id-source: derived
  /chats/{id}/steer:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id steer
      x-summary-source: derived
      operationId: postChatsByIdSteer
      x-operation-id-source: derived
  /chats/{id}/stop:
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id stop
      x-summary-source: derived
      operationId: postChatsByIdStop
      x-operation-id-source: derived
  /chats/{id}/stream:
    connect:
      tags:
      - chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
    query:
      tags:
      - chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
    delete:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Delete chats by id stream
      x-summary-source: derived
      operationId: deleteChatsByIdStream
      x-operation-id-source: derived
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id stream
      x-summary-source: derived
      operationId: getChatsByIdStream
      x-operation-id-source: derived
    head:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Check chats by id stream
      x-summary-source: derived
      operationId: headChatsByIdStream
      x-operation-id-source: derived
    options:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Describe chats by id stream
      x-summary-source: derived
      operationId: optionsChatsByIdStream
      x-operation-id-source: derived
    patch:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Update chats by id stream
      x-summary-source: derived
      operationId: patchChatsByIdStream
      x-operation-id-source: derived
    post:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create chats by id stream
      x-summary-source: derived
      operationId: postChatsByIdStream
      x-operation-id-source: derived
    put:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Replace chats by id stream
      x-summary-source: derived
      operationId: putChatsByIdStream
      x-operation-id-source: derived
    trace:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Trace chats by id stream
      x-summary-source: derived
      operationId: traceChatsByIdStream
      x-operation-id-source: derived
  /chats/{id}/trace:
    get:
      tags:
      - Chats
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Get chats by id trace
      x-summary-source: derived
      operationId: getChatsByIdTrace
      x-operation-id-source: derived
  /tools/{toolId}:
    post:
      tags:
      - Chats
      parameters:
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create tools by tool id
      x-summary-source: derived
      operationId: postToolsByToolId
      x-operation-id-source: derived
  /tools/{toolId}/invoke:
    post:
      tags:
      - Chats
      parameters:
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create tools by tool id invoke
      x-summary-source: derived
      operationId: postToolsByToolIdInvoke
      x-operation-id-source: derived
  /tools/{toolId}/reject:
    post:
      tags:
      - Chats
      parameters:
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create tools by tool id reject
      x-summary-source: derived
      operationId: postToolsByToolIdReject
      x-operation-id-source: derived
  /tools/{toolId}/widget:
    post:
      tags:
      - Chats
      parameters:
      - name: toolId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
      summary: Create tools by tool id widget
      x-summary-source: derived
      operationId: postToolsByToolIdWidget
      x-operation-id-source: derived