> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-smedina-x-calls-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a scheduled call

> Cancels a scheduled call the authenticated user organizes, and takes it off invitees' calendars. For a recurring call, scope and occurrence_start_time pick the occurrences: all of them (the default), one, or one and every one after it. Cancelling what is already cancelled succeeds.



## OpenAPI

````yaml xcalls/openapi.json DELETE /2/calls/scheduled/{id}
openapi: 3.0.0
info:
  title: X Calls API
  version: '2'
  description: >-
    Start, join and schedule X calls as your app's user, and put a voice agent
    in them. In development: endpoints and payloads may change.
servers:
  - description: X API
    url: https://api.x.com
security: []
tags:
  - name: Calls
paths:
  /2/calls/scheduled/{id}:
    delete:
      tags:
        - Calls
      summary: Cancel a scheduled call
      description: >-
        Cancels a scheduled call the authenticated user organizes, and takes it
        off invitees' calendars. For a recurring call, scope and
        occurrence_start_time pick the occurrences: all of them (the default),
        one, or one and every one after it. Cancelling what is already cancelled
        succeeds.
      operationId: cancelScheduledCall
      parameters:
        - in: path
          name: id
          required: true
          schema:
            pattern: ^[0-9]{1,19}$
            type: string
          style: simple
        - description: >-
            Which occurrences: all (the default without occurrence_start_time),
            this (the default with it), or this_and_following.
          in: query
          name: scope
          required: false
          schema:
            enum:
              - all
              - this
              - this_and_following
            type: string
          style: form
        - description: >-
            Start of the occurrence that scope this or this_and_following refers
            to (RFC 3339).
          in: query
          name: occurrence_start_time
          required: false
          schema:
            format: date-time
            type: string
          style: form
        - description: Whether invitees get an email about it. Defaults to true.
          in: query
          name: notify_invitees
          required: false
          schema:
            type: boolean
          style: form
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelScheduledCallResponse'
          description: The request has succeeded.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: The request has failed.
      security:
        - OAuth2UserToken:
            - tweet.read
            - dm.write
            - users.read
        - UserToken: []
components:
  schemas:
    CancelScheduledCallResponse:
      properties:
        data:
          $ref: '#/components/schemas/CancelScheduledCallResponseData'
        errors:
          items:
            $ref: '#/components/schemas/Problem'
          type: array
      type: object
    Error:
      properties:
        code:
          format: int32
          type: integer
        message:
          type: string
      required:
        - code
        - message
      type: object
    Problem:
      discriminator:
        mapping:
          https://api.twitter.com/2/problems/duplicate-rules: '#/components/schemas/DuplicateRuleProblem'
          https://api.twitter.com/2/problems/invalid-rules: '#/components/schemas/InvalidRuleProblem'
          https://api.x.com/2/problems/disallowed-resource: '#/components/schemas/DisallowedResourceProblem'
          https://api.x.com/2/problems/field-hydration-failure: '#/components/schemas/FieldHydrationFailureProblem'
          https://api.x.com/2/problems/field-unauthorized: '#/components/schemas/FieldUnauthorizedProblem'
          https://api.x.com/2/problems/internal-error: '#/components/schemas/InternalErrorProblem'
          https://api.x.com/2/problems/invalid-request: '#/components/schemas/InvalidRequestProblem'
          https://api.x.com/2/problems/not-authorized-for-field: '#/components/schemas/NotAuthorizedForFieldProblem'
          https://api.x.com/2/problems/not-authorized-for-resource: '#/components/schemas/NotAuthorizedForResourceProblem'
          https://api.x.com/2/problems/recipient-not-messageable: '#/components/schemas/RecipientNotMessageableProblem'
          https://api.x.com/2/problems/resource-not-found: '#/components/schemas/ResourceNotFoundProblem'
          https://api.x.com/2/problems/resource-unavailable: '#/components/schemas/ResourceUnavailableProblem'
        propertyName: type
      oneOf:
        - $ref: '#/components/schemas/ResourceNotFoundProblem'
        - $ref: '#/components/schemas/InvalidRequestProblem'
        - $ref: '#/components/schemas/NotAuthorizedForResourceProblem'
        - $ref: '#/components/schemas/NotAuthorizedForFieldProblem'
        - $ref: '#/components/schemas/FieldUnauthorizedProblem'
        - $ref: '#/components/schemas/FieldHydrationFailureProblem'
        - $ref: '#/components/schemas/ResourceUnavailableProblem'
        - $ref: '#/components/schemas/DisallowedResourceProblem'
        - $ref: '#/components/schemas/RecipientNotMessageableProblem'
        - $ref: '#/components/schemas/InternalErrorProblem'
        - $ref: '#/components/schemas/DuplicateRuleProblem'
        - $ref: '#/components/schemas/InvalidRuleProblem'
    CancelScheduledCallResponseData:
      additionalProperties: false
      properties:
        cancelled:
          description: Whether the occurrences are cancelled.
          type: boolean
      type: object
    DuplicateRuleProblem:
      properties:
        detail:
          type: string
        id:
          type: string
        title:
          type: string
        type:
          enum:
            - https://api.twitter.com/2/problems/duplicate-rules
          type: string
        value:
          type: string
      required:
        - type
        - title
        - value
      type: object
    InvalidRuleProblem:
      properties:
        detail:
          type: string
        details:
          items:
            type: string
          type: array
        title:
          type: string
        type:
          enum:
            - https://api.twitter.com/2/problems/invalid-rules
          type: string
        value:
          type: string
      required:
        - type
        - title
        - details
      type: object
    DisallowedResourceProblem:
      properties:
        detail:
          type: string
        resource_id:
          type: string
        resource_type:
          type: string
        section:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/disallowed-resource
          type: string
      required:
        - type
        - title
        - detail
      type: object
    FieldHydrationFailureProblem:
      properties:
        detail:
          type: string
        field:
          type: string
        resource_type:
          type: string
        section:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/field-hydration-failure
          type: string
      required:
        - type
        - title
        - detail
        - field
      type: object
    FieldUnauthorizedProblem:
      properties:
        detail:
          type: string
        field:
          type: string
        resource_type:
          type: string
        section:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/field-unauthorized
          type: string
      required:
        - type
        - title
        - detail
        - field
      type: object
    InternalErrorProblem:
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/internal-error
          type: string
      required:
        - type
        - title
        - detail
      type: object
    InvalidRequestProblem:
      properties:
        detail:
          type: string
        parameter:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/invalid-request
          type: string
        value:
          type: string
      required:
        - type
        - title
        - detail
      type: object
    NotAuthorizedForFieldProblem:
      properties:
        detail:
          type: string
        field:
          type: string
        parameter:
          type: string
        resource_id:
          type: string
        resource_type:
          type: string
        section:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/not-authorized-for-field
          type: string
        value:
          type: string
      required:
        - type
        - title
        - detail
        - field
      type: object
    NotAuthorizedForResourceProblem:
      properties:
        detail:
          type: string
        parameter:
          type: string
        resource_id:
          type: string
        resource_type:
          type: string
        section:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/not-authorized-for-resource
          type: string
        value:
          type: string
      required:
        - type
        - title
        - detail
        - resource_type
      type: object
    RecipientNotMessageableProblem:
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/recipient-not-messageable
          type: string
      required:
        - type
        - title
        - detail
      type: object
    ResourceNotFoundProblem:
      properties:
        detail:
          type: string
        parameter:
          type: string
        resource_id:
          type: string
        resource_type:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/resource-not-found
          type: string
        value:
          type: string
      required:
        - type
        - title
        - detail
        - resource_type
      type: object
    ResourceUnavailableProblem:
      properties:
        detail:
          type: string
        resource_id:
          type: string
        resource_type:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          enum:
            - https://api.x.com/2/problems/resource-unavailable
          type: string
      required:
        - type
        - title
        - detail
        - resource_type
      type: object
  securitySchemes:
    OAuth2UserToken:
      flows:
        authorizationCode:
          authorizationUrl: https://api.x.com/2/oauth2/authorize
          scopes:
            block.read: View accounts you have blocked.
            block.write: Block and unblock accounts on your behalf.
            bookmark.read: Read your bookmarked Posts.
            bookmark.write: Create and delete your bookmarks.
            broadcast.read: View your live broadcasts and their chat.
            broadcast.write: Manage your live broadcasts and send chat messages on your behalf.
            developer.read: View your developer accounts, apps, and settings.
            developer.write: Create and manage your X Developer Platform account.
            dm.read: Read all your Direct Messages.
            dm.write: Send and manage your Direct Messages.
            follows.read: View accounts you follow and accounts following you.
            follows.write: Follow and unfollow accounts on your behalf.
            like.read: View Posts you have liked and likes you can see.
            like.write: Like and unlike Posts on your behalf.
            list.read: >-
              View Lists, members, and followers of Lists you created or are a
              member of, including private Lists.
            list.write: Create and manage Lists on your behalf.
            media.write: Upload media, such as photos and videos, on your behalf.
            mute.read: View accounts you have muted.
            mute.write: Mute and unmute accounts on your behalf.
            offline.access: Request a refresh token for the app.
            space.read: View all Spaces you have access to.
            timeline.read: View all Custom Timelines you can see.
            tweet.moderate.write: Hide and unhide replies to your posts.
            tweet.read: >-
              View all posts you can see, including those from protected
              accounts.
            tweet.write: Create and repost on your behalf.
            users.read: View any account you can see, including protected accounts.
          tokenUrl: https://api.x.com/2/oauth2/token
      type: oauth2
    UserToken:
      scheme: OAuth
      type: http

````