Call2Me Web Call API

The WebCall API from Call2Me — 4 operation(s) for webcall.

Operations 6

GET /v1/web-call/config/{agent_id} Get Config #
PUT /v1/web-call/config/{agent_id} Put Config #
POST /v1/web-call/start Start Web Call #
GET /v1/web-call/public-config/{agent_id} Get Public Config #
PUT /v1/web-call/public-config/{agent_id} Put Public Config #
POST /v1/web-call/regenerate-token/{agent_id} Regenerate Public Token #

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/call2me-app:call2me-app-webcall-api"
All apis
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.

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

call2me-app-webcall-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Call2Me Web Call API
  description: '# Call2Me Voice AI Platform API


    Programmatic interface to build, deploy and operate voice AI agents that can place

    and receive phone calls in real time. Designed to be consumed by humans **and** by

    AI agent frameworks (function-calling LLMs, MCP servers, automation platforms like

    Composio, Pipedream, Zapier, n8n).


    ## What you can do


    - **Place outbound calls** — give an agent a phone number to dial; the AI handles

    the conversation end-to-end and returns a transcript + recording.

    - **Manage AI agents** — create personalities, attach voices, system prompts,

    knowledge bases and post-call actions.

    - **Schedule calls** — one-shot or recurring (cron-like) outbound calls.

    - **Knowledge base (RAG)** — upload documents/URLs so the agent answers from your

    data with reduced hallucination.

    - **Inbound** — provision phone numbers that route to your agents.


    ## Common LLM tool-calling use cases


    | Goal | Endpoint |

    |------|----------|

    | "Call this person and read them this script" | `POST /v1/calls` |

    | "Schedule a follow-up tomorrow at 14:00" | `POST /v1/schedules` |

    | "Get the transcript of last call" | `GET /v1/calls/{id}` |

    | "Add this PDF to the agent''s brain" | `POST /v1/knowledge-base/{id}/sources` |


    ## Authentication


    Every request requires a Bearer token issued from the dashboard:


    ```

    Authorization: Bearer c2m_sk_xxxxxxxxxxxxxxxx

    ```


    Get your API key from the API Keys page.

    Keys are scoped per-workspace and can be rotated/revoked any time.


    ## Rate Limits


    | Plan | Requests/min | Concurrent Calls |

    |------|-------------|------------------|

    | Free | 60 | 1 |

    | Pro | 600 | 10 |

    | Enterprise | Unlimited | Unlimited |


    ## SDKs & Integrations


    - Python SDK

    - Node.js SDK

    - OpenAPI 3.1 spec: `/openapi.json` (use it to generate clients or register the

    service with AI tool platforms)


    ## Support


    - Email: support@call2me.app

    - Docs: https://docs.call2me.app

    - Discord: https://discord.gg/call2me'
  version: 1.0.0
  x-logo:
    url: https://call2me.app/logo.png
    altText: Call2Me Logo
  contact:
    name: Call2Me Support
    url: https://call2me.app/support
    email: support@call2me.app
  license:
    name: Commercial — see Terms of Service
    url: https://call2me.app/terms
  termsOfService: https://call2me.app/terms
servers:
- url: https://api.call2me.app
  description: Production
- url: http://localhost:8000
  description: Local Development
security:
- BearerAuth: []
tags:
- name: WebCall
paths:
  /v1/web-call/config/{agent_id}:
    get:
      tags:
      - WebCall
      summary: Get Config
      operationId: get_config_v1_web_call_config__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:
                anyOf:
                - $ref: '#/components/schemas/WebCallConfig'
                - type: 'null'
                title: Response Get Config V1 Web Call Config  Agent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - WebCall
      summary: Put Config
      operationId: put_config_v1_web_call_config__agent_id__put
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebCallConfigUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebCallConfig'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/web-call/start:
    post:
      tags:
      - WebCall
      summary: Start Web Call
      operationId: start_web_call_v1_web_call_start_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebCallStartRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebCallStartResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/web-call/public-config/{agent_id}:
    get:
      tags:
      - WebCall
      summary: Get Public Config
      operationId: get_public_config_v1_web_call_public_config__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:
                anyOf:
                - $ref: '#/components/schemas/WebCallPublicConfig'
                - type: 'null'
                title: Response Get Public Config V1 Web Call Public Config  Agent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - WebCall
      summary: Put Public Config
      operationId: put_public_config_v1_web_call_public_config__agent_id__put
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebCallPublicConfigUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebCallPublicConfig'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/web-call/regenerate-token/{agent_id}:
    post:
      tags:
      - WebCall
      summary: Regenerate Public Token
      operationId: regenerate_public_token_v1_web_call_regenerate_token__agent_id__post
      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 Regenerate Public Token V1 Web Call Regenerate Token  Agent Id  Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    WebCallStartRequest:
      properties:
        agent_id:
          type: string
          title: Agent Id
        to_number:
          type: string
          title: To Number
      type: object
      required:
      - agent_id
      - to_number
      title: WebCallStartRequest
    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
    WebCallPublicConfigUpdate:
      properties:
        public_enabled:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Public Enabled
        target_number:
          anyOf:
          - type: string
          - type: 'null'
          title: Target Number
        allowed_domains:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Allowed Domains
        daily_call_limit:
          anyOf:
          - type: integer
          - type: 'null'
          title: Daily Call Limit
        ip_rate_per_min:
          anyOf:
          - type: integer
          - type: 'null'
          title: Ip Rate Per Min
        max_duration_sec:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Duration Sec
      type: object
      title: WebCallPublicConfigUpdate
    WebCallStartResponse:
      properties:
        call_id:
          type: string
          title: Call Id
        room_name:
          type: string
          title: Room Name
        web_token:
          type: string
          title: Web Token
        livekit_url:
          type: string
          title: Livekit Url
        from_number:
          type: string
          title: From Number
        to_number:
          type: string
          title: To Number
      type: object
      required:
      - call_id
      - room_name
      - web_token
      - livekit_url
      - from_number
      - to_number
      title: WebCallStartResponse
    WebCallConfigUpdate:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        enabled:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Enabled
        record_enabled:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Record Enabled
      type: object
      title: WebCallConfigUpdate
    WebCallPublicConfig:
      properties:
        id:
          type: string
          title: Id
        agent_id:
          type: string
          title: Agent Id
        public_enabled:
          type: boolean
          title: Public Enabled
        target_number:
          anyOf:
          - type: string
          - type: 'null'
          title: Target Number
        public_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Public Token
        allowed_domains:
          items:
            type: string
          type: array
          title: Allowed Domains
        daily_call_limit:
          type: integer
          title: Daily Call Limit
        ip_rate_per_min:
          type: integer
          title: Ip Rate Per Min
        max_duration_sec:
          type: integer
          title: Max Duration Sec
      type: object
      required:
      - id
      - agent_id
      - public_enabled
      - target_number
      - public_token
      - allowed_domains
      - daily_call_limit
      - ip_rate_per_min
      - max_duration_sec
      title: WebCallPublicConfig
    WebCallConfig:
      properties:
        id:
          type: string
          title: Id
        agent_id:
          type: string
          title: Agent Id
        name:
          type: string
          title: Name
        enabled:
          type: boolean
          title: Enabled
        record_enabled:
          type: boolean
          title: Record Enabled
      type: object
      required:
      - id
      - agent_id
      - name
      - enabled
      - record_enabled
      title: WebCallConfig
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Enter your API key
externalDocs:
  description: Full developer documentation
  url: https://docs.call2me.app