Celesto AI agentor API

openapi: 3.1.0
info:
  title: Celesto AI agentor API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 6 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Celesto AI has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 10
    documentation: 6
    pages-with-code: 12
    pages-read: 15
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://celesto.ai/docs/agentor/api/a2a/controller
  - https://celesto.ai/docs/agentor/concepts/a2a-protocol
  - https://celesto.ai/docs/agentor/deploy
  - https://celesto.ai/docs/agentor/installation
  - https://celesto.ai/docs/agentor/quickstart
  x-docs-section: agentor
paths:
  /:
    post:
      operationId: post
      tags:
      - Api
      summary: POST /
      x-source: https://celesto.ai/docs/agentor/concepts/a2a-protocol
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST http://localhost:8000/  -H \"Content-Type: application/json\"  -d '{ \n \"jsonrpc\": \"2.0\", \n \"id\": 1, \n\
          \ \"method\": \"message/stream\", \n \"params\": { \n \"message\": { \n \"parts\": [{\"kind\": \"text\", \"text\": \"Hello!\"}] \n }\
          \ \n } \n }' \n ​ Integration with FastAPI \n The A2A controller is a FastAPI router: \n from fastapi import FastAPI \n app = FastAPI()\
          \ \n app.include_router(controller) \n This enables: \n"
  /.well-known/agent-card.json:
    get:
      operationId: get_well_known_agent_card_json
      tags:
      - API
      summary: Returns the agent card manifest following A2A protocol v0.3.0
      x-source: https://celesto.ai/docs/agentor/api/a2a/controller
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /chat:
    get:
      operationId: get_chat
      tags:
      - Chat
      summary: GET /chat
      x-source: https://celesto.ai/docs/agentor/deploy
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetChatResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl import requests \n URL = \"http://localhost:8000/chat\" \n response = requests.post( \n URL , \n json = { \"input\" : \"\
          how are you?\" }, \n headers = { \"Content-Type\" : \"application/json\" } \n ) \n print (response.content) \n import requests "
    post:
      operationId: post_chat
      tags:
      - Chat
      summary: POST /chat
      x-source: https://celesto.ai/docs/agentor/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostChatRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X 'POST'  'http://localhost:8000/chat'  -H 'accept: application/json'  -H 'Content-Type: application/json'  -d '{ \n \"\
          input\": \"What is the weather in London?\" \n }' \n ​ Deploy to production \n Deploy your agent to Celesto AI’s serverless platform:\
          \ \n 1 Install the Celesto CLI The CLI is included with Agentor: celesto --version \n 2 Create your agent file Save your agent code\
          \ to a Python file (e.g"
  /health:
    get:
      operationId: get_health
      tags:
      - Health
      summary: Serve agents as an API
      x-source: https://celesto.ai/docs/agentor/deploy
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /uv/install.sh:
    get:
      operationId: get_uv_install_sh
      tags:
      - Uv
      summary: GET /uv/install.sh
      x-source: https://celesto.ai/docs/agentor/installation
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -LsSf https://astral.sh/uv/install.sh | sh \n uv pip install agentor \n ​ Install from source \n To install the latest\
          \ development version directly from GitHub: \n pip install git+https://github.com/celestoai/agentor@main \n The development version\
          \ may contain unreleased features and breaking changes. Use this only if you need cutting-edge features or want to contribute. \n ​\
          \ Optional dependencies "
components:
  schemas:
    PostRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            message:
              type: object
              properties:
                parts:
                  type: array
                  items:
                    type: object
                    properties:
                      kind:
                        type: string
                      text:
                        type: string
    GetChatResponse:
      type: object
      properties:
        input:
          type: string
    PostChatRequest:
      type: object
      properties:
        input:
          type: string
  securitySchemes:
    CELESTO_API_KEY:
      type: apiKey
      in: header
      name: Authorization
      x-source: https://celesto.ai/docs/cloud/authentication
tags:
- name: API
- name: Api
- name: Chat
- name: Health
- name: Uv
security:
- CELESTO_API_KEY: []