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

# Decline queued sends awaiting review

> Declines queued sends. A declined row moves to `stopped`, which is TERMINAL for that contact: unlike skip, the sequence does not advance, so no further step is scheduled for the contact in this campaign. Decline reaches both AI drafts awaiting review (`approval_required`) and ordinary queued rows (`scheduled`), so it is also how you call off an upcoming send for one contact. Only sends belonging to campaigns you own can be declined. The answer reports every id you passed: `declined` are the ones that moved, `ignored` are your sends in a state decline cannot move (already sent, skipped, stopped or overwritten), and `notFound` are ids that do not exist, are not yours, or belong to a deleted campaign. Rate limit: 30 requests/minute and 1,000/day per token owner, shared by every campaign, scheduled-send, campaign-template and knowledge-hub endpoint.

Errors:
- `422` `VALIDATION_FAILED` — sendIds is missing, empty, longer than 100, contains a duplicate, or an entry is not a 24-character hex id; `param` names the field.
- `429` `RATE_LIMITED` — More than 30 campaign requests in a minute, or 1,000 in a day, for this token owner (the bucket is shared by every /business/campaigns, /business/scheduled-sends, /business/campaign-templates and /business/knowledge-hubs call).
- `500` `UNEXPECTED_ERROR` — An unhandled failure; the detail stays in our logs and is never returned.

Requires one of the following token scopes: campaigns.



## OpenAPI

````yaml /openapi.json post /business/scheduled-sends/decline
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/scheduled-sends/decline:
    post:
      tags:
        - Scheduled sends
      summary: Decline queued sends awaiting review
      description: >-
        Declines queued sends. A declined row moves to `stopped`, which is
        TERMINAL for that contact: unlike skip, the sequence does not advance,
        so no further step is scheduled for the contact in this campaign.
        Decline reaches both AI drafts awaiting review (`approval_required`) and
        ordinary queued rows (`scheduled`), so it is also how you call off an
        upcoming send for one contact. Only sends belonging to campaigns you own
        can be declined. The answer reports every id you passed: `declined` are
        the ones that moved, `ignored` are your sends in a state decline cannot
        move (already sent, skipped, stopped or overwritten), and `notFound` are
        ids that do not exist, are not yours, or belong to a deleted campaign.
        Rate limit: 30 requests/minute and 1,000/day per token owner, shared by
        every campaign, scheduled-send, campaign-template and knowledge-hub
        endpoint.


        Errors:

        - `422` `VALIDATION_FAILED` — sendIds is missing, empty, longer than
        100, contains a duplicate, or an entry is not a 24-character hex id;
        `param` names the field.

        - `429` `RATE_LIMITED` — More than 30 campaign requests in a minute, or
        1,000 in a day, for this token owner (the bucket is shared by every
        /business/campaigns, /business/scheduled-sends,
        /business/campaign-templates and /business/knowledge-hubs call).

        - `500` `UNEXPECTED_ERROR` — An unhandled failure; the detail stays in
        our logs and is never returned.


        Requires one of the following token scopes: campaigns.
      operationId: declineScheduledSends
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                sendIds:
                  type: array
                  items:
                    type: string
                    description: A queued send id (24-character hex ObjectId).
                  minItems: 1
                  maxItems: 100
                  description: >-
                    1-100 unique queued-send ids. Approve moves rows in
                    approval_required to scheduled; decline moves rows in
                    approval_required or scheduled to stopped, which also halts
                    that contact's sequence. Ids you do not own are reported
                    under notFound; ids in a state the decision cannot move are
                    reported under ignored.
              required:
                - sendIds
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                properties:
                  declined:
                    type: array
                    items:
                      type: string
                    description: >-
                      Ids that moved to stopped, halting that contact's
                      sequence.
                  ignored:
                    type: array
                    items:
                      type: string
                    description: >-
                      Your sends that decline cannot move in their current
                      state.
                  notFound:
                    type: array
                    items:
                      type: string
                    description: >-
                      Ids that do not exist or belong to a campaign you do not
                      own.
                required:
                  - declined
                  - ignored
                  - notFound
              example:
                declined:
                  - 6a8dce70a4566f4f2454bd4f
                ignored:
                  - 6a8da7adafc401ca94530e14
                notFound:
                  - '000000000000000000000001'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````