generated: '2026-09-11'
method: searched
source: >-
  https://platform-docs.sarj.ai/.well-known/agent-skills/index.json,
  https://platform-docs.sarj.ai/.well-known/agent-skills/sarj/skill.md
note: >-
  Sarj publishes its own Agent Skill and now advertises it from THREE places — its A2A agent card, an
  agentskills.io discovery index at /.well-known/agent-skills/index.json, and a rel="agent-skills" Link
  header on every docs response. The provider skill is harvested verbatim. One companion skill is generated
  by this pipeline and is labelled as such; it exists because the provider's own skill documents two
  endpoints that its OpenAPI does not define.
discovery:
  index: https://platform-docs.sarj.ai/.well-known/agent-skills/index.json
  index_schema: https://schemas.agentskills.io/discovery/0.2.0/schema.json
  digest_published: sha256:856e9f515005ebfd4e5b9cc6e522f9b43aa64d057f9727ec289f97e24103b528
  digest_verified_against_harvest: true
skills:
  - file: sarj-ai-developer-api-sarj.md
    name: Sarj
    method: searched
    description: >-
      Use when placing outbound voice calls, tracking call status and transcripts, managing scheduled calls
      with retries, or integrating voice AI into applications.
    api: openapi/_original/sarj-ai-developer-api-developer-openapi.json
    operations:
      - getHealth
      - createCall
      - getCall
      - createScheduleConfig
    published_by: provider
    published_at: https://platform-docs.sarj.ai/.well-known/agent-skills/sarj/skill.md
    discovered_via: https://platform-docs.sarj.ai/.well-known/agent-card.json
    format: frontmatter + markdown (name, description, metadata)
    bytes: 9696
    sha256: 856e9f515005ebfd4e5b9cc6e522f9b43aa64d057f9727ec289f97e24103b528
    refreshed: '2026-09-11'
    change_since_last_pass: >-
      Rewritten and restructured by the provider. It now covers scheduled calls, cancel/reschedule, retry
      policies, permanent_recording_url and booking_outcome, and drops the speech-API material the previous
      version carried.
    sections:
      - Product Summary
      - When to Use
      - Quick Reference
      - Decision Guidance
      - Workflow
      - Common Gotchas
      - Verification Checklist
      - Resources
    accuracy_check:
      checked_against: openapi/_original/sarj-ai-developer-api-developer-openapi.json
      checked_on: '2026-09-11'
      verified:
        - booking_outcome enum (created / rescheduled_existing / kept_existing) — present in PublicCall
        - permanent_recording_url and the recording_url deprecation — present in PublicCallDetail
        - scheduled_at bounds (>= 10 minutes, <= 30 days) — present in CreateCallRequest
        - schedule config create-only limitation — stated in the createScheduleConfig description
        - 409 on cancel/reschedule after release — present in both operations
      defects:
        - id: wrong-method-and-path-for-cancel-and-reschedule
          severity: high
          detail: >-
            The skill's API Endpoints table lists `DELETE /calls/{call_id}` for "Cancel pending scheduled
            call" and `PATCH /calls/{call_id}` for "Reschedule pending call". Neither exists in the OpenAPI.
            The real operations are POST /calls/{call_id}/cancel (cancelScheduledCall) and
            POST /calls/{call_id}/reschedule (rescheduleScheduledCall). An agent following the published
            skill literally will fail to cancel a call — the one operation on this API you least want an
            agent to get wrong, because it is the stop-calling lever.
          action: Raise with the provider.
  - file: sarj-ai-developer-api-scheduled-calls.md
    name: sarj-scheduled-calls
    method: generated
    description: >-
      Booking a call for a future time, cancelling a booked call or a pending retry chain, rescheduling, and
      creating a retry policy — with the correct paths and the published numeric bounds.
    api: openapi/_original/sarj-ai-developer-api-developer-openapi.json
    operations:
      - createCall
      - cancelScheduledCall
      - rescheduleScheduledCall
      - createScheduleConfig
      - getCall
    published_by: api-evangelist
    grounded_in: >-
      Every operationId, path, method, field, status code and numeric bound is read from the harvested
      OpenAPI. It exists to cover the reversal path the MCP server does not expose and to correct the
      endpoint defect recorded above.
x-evidence:
  - url: https://platform-docs.sarj.ai/.well-known/agent-skills/index.json
    http_status: 200
    content_type: application/json
  - url: https://platform-docs.sarj.ai/.well-known/agent-skills/sarj/skill.md
    http_status: 200
    content_type: text/markdown; charset=utf-8
  - url: https://platform-api.sarj.ai/api/v1/openapi.json
    http_status: 200