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

# Cancel send

> Takes a Scheduled reply out of the owner's send queue before Extrovert starts sending it. The reply returns to Draft ready with the same text and nothing is sent. Once Extrovert has started sending it, the call fails with a conflict and the reply stays as it is. Returns the reply and the conversation's situation after the cancel.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json post /client/v2/dm-replies/{dmId}/cancel-send
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/dm-replies/{dmId}/cancel-send:
    post:
      tags:
        - Direct Messages
      summary: Cancel send
      description: >-
        Takes a Scheduled reply out of the owner's send queue before Extrovert
        starts sending it. The reply returns to Draft ready with the same text
        and nothing is sent. Once Extrovert has started sending it, the call
        fails with a conflict and the reply stays as it is. Returns the reply
        and the conversation's situation after the cancel.
      operationId: DmRepliesClientApiController_cancelSend
      parameters:
        - name: dmId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelSendRequestDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelSendResponseDto'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    CancelSendRequestDto:
      type: object
      properties:
        dmId:
          type: string
          format: uuid
          description: >-
            Exact ID of the Scheduled reply, from scheduledReply or activeReply
            of the conversation.
      required:
        - dmId
    CancelSendResponseDto:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: object
          properties:
            dmId:
              type: string
              format: uuid
              description: Exact reply ID required by Edit, Send, and Recover.
              examples:
                - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
            connectionId:
              type: string
              format: uuid
              description: Conversation this reply belongs to.
              examples:
                - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
            text:
              type: string
              minLength: 1
              description: Effective reply text.
            source:
              type: string
              enum:
                - Extrovert-generated
                - Agent-authored
                - Edited
              description: >-
                Extrovert-generated when no authored override exists;
                Agent-authored when created without generation; Edited when
                custom text overrides a generated reply.
            state:
              type: string
              enum:
                - No draft
                - Suggested
                - Draft ready
                - Generating
                - Scheduled
                - Sending
                - Sent
                - History changed
                - Error
                - Paused
                - Skipped
            allowedActions:
              type: array
              items:
                type: string
                enum:
                  - prepare-reply
                  - generate-or-improve-reply
                  - edit-reply
                  - send-reply
                  - recover-draft
                  - cancel-send
              description: Actions valid for the current state.
            reason:
              anyOf:
                - type: string
                  enum:
                    - Relevant post
                    - Follow-up
                    - First outreach
                    - Manual
                - type: 'null'
              description: >-
                Why Extrovert recommended this conversation, or null when no
                automatic reason applies.
            followUpNumber:
              anyOf:
                - type: integer
                  minimum: 1
                  maximum: 9007199254740991
                - type: 'null'
              description: >-
                Which follow-up of the unanswered series is due, counting from
                1. Null outside a follow-up series.
              examples:
                - 1
                - 3
            error:
              anyOf:
                - type: object
                  properties:
                    code:
                      type: string
                      description: >-
                        Stable public error code suitable for branching. It is
                        not a raw provider or backend status.
                    message:
                      type: string
                      description: >-
                        Safe explanation of what failed and what the caller
                        should do next.
                    retryable:
                      type: boolean
                      description: >-
                        Whether retrying may succeed after the stated condition
                        is resolved.
                    occurredAt:
                      anyOf:
                        - type: string
                          description: Date and time in ISO 8601 format
                          examples:
                            - '2025-06-30T14:02:07.456Z'
                            - '2025-07-03T08:30:00.000Z'
                        - type: 'null'
                      description: >-
                        When this failure was recorded, or null when no reliable
                        timestamp exists.
                  required:
                    - code
                    - message
                    - retryable
                    - occurredAt
                - type: 'null'
              description: >-
                Current send/workflow failure, or null when no failure is
                active.
            autoAttempt:
              anyOf:
                - type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - first-dm
                        - follow-up
                      description: Which automatic step sent the message.
                    followUpNumber:
                      anyOf:
                        - type: integer
                          minimum: 1
                          maximum: 9007199254740991
                        - type: 'null'
                      description: >-
                        Follow-up number in the series at send time; null for a
                        first DM.
                    followUpLimit:
                      anyOf:
                        - type: integer
                          minimum: 1
                          maximum: 9007199254740991
                        - type: 'null'
                      description: >-
                        Follow-up limit of the campaign at send time; null when
                        unlimited or not recorded.
                  required:
                    - type
                    - followUpNumber
                    - followUpLimit
                - type: 'null'
              description: >-
                Set while this reply is an automatic send attempt that failed or
                whose outcome is unknown: the step Extrovert's automatic sending
                tried. Null for a person's reply and after it is recovered,
                edited or resent.
            createdAt:
              type: string
              description: Date and time in ISO 8601 format
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            updatedAt:
              type: string
              description: Date and time in ISO 8601 format
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            sentAt:
              anyOf:
                - type: string
                  description: Date and time in ISO 8601 format
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                - type: 'null'
              description: >-
                Time the reply was sent to LinkedIn, or null while it is not
                sent. Not a delivery or read confirmation.
            situation:
              type: string
              description: >-
                Plain summary of this conversation at the time of this read.
                "This LinkedIn account" is ownerId. Relative times are counted
                from this read. A quoted "Extrovert's note" is Extrovert's
                stored explanation.
          required:
            - dmId
            - connectionId
            - text
            - source
            - state
            - allowedActions
            - reason
            - followUpNumber
            - error
            - autoAttempt
            - createdAt
            - updatedAt
            - sentAt
            - situation
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: 'null'
          description: Response data
          example: null
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

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