> ## Documentation Index
> Fetch the complete documentation index at: https://platform-docs.sarj.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use OpenAPI for fields and errors; the Python guide and PyPI for SDK capabilities and availability. Scenario IDs are dashboard UUIDs. Bound polling; reports may stay null. Reconcile ambiguous call creation before retrying. Docs MCP reads docs and accepts feedback; API MCP performs authenticated call actions.

# Receive a call outcome

> Sent to your webhook URL, not a Sarj API endpoint. Use its optional configured credential, not your API key. Persist and deduplicate by `call_id`, then acknowledge within 5 seconds. `complete` includes voicemail; inspect `payload.call_data.status` for its outcome.



## OpenAPI

````yaml /api-reference/openapi.json webhook callEnded
openapi: 3.1.0
info:
  title: Sarj.ai Developer API
  description: >
    Create calls, schedule retries, and retrieve outcomes.


    [Quickstart](https://platform-docs.sarj.ai/getting-started) ·

    [Authentication and
    errors](https://platform-docs.sarj.ai/api-reference/overview) ·

    [MCP guide](https://platform-docs.sarj.ai/mcp-server)
  license:
    name: Apache 2.0
    identifier: Apache-2.0
  version: 1.1.0
servers:
  - url: https://platform-api.sarj.ai/api/v1
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: System
    description: Service health and status.
  - name: Calls
    description: Create outbound voice calls and retrieve call details and transcripts.
  - name: Call History
    description: List calls and read call transcripts with timestamps.
  - name: Schedule Configs
    description: Create and manage retry policies for scheduled outbound calls.
  - name: Scenarios
    description: Read scenario configuration.
  - name: Knowledge Bases
    description: Read and replace knowledge base content.
  - name: Scenario Tests
    description: >-
      Run automated chat tests against a scenario with mocked tools and read
      their results.
  - name: Scenario Prompts
    description: Read scenario prompts and save prompt drafts.
  - name: Integrations
    description: >-
      List the connections and integrations an organization can use, without
      secrets.
  - name: Scenario Tools
    description: Read and change a scenario's tools without values that could be secrets.
  - name: Personas
    description: Read, create and update personas, and read voices.
  - name: Feedback
    description: Send feedback about these tools to the Sarj team.
  - name: Webhooks
    description: Receive call outcomes at your configured endpoint.
externalDocs:
  description: Sarj.ai Documentation
  url: https://platform-docs.sarj.ai
paths: {}
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: API key from your Sarj.ai dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.