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

# Resume Queue

> Resume a paused queue. Its pending cases start on the next dispatch, within the queue's concurrency limit. Resuming a queue that is not paused changes nothing. Only a builder or team admin, or someone whose case trigger on the queue is on, can resume it.



## OpenAPI

````yaml https://api.duvo.ai/v2/documentation/mintlify.json post /v2/queues/{queue_id}/resume
openapi: 3.0.3
info:
  title: Duvo Public API
  description: >-
    Public API for programmatic access to Duvo. Authenticate with API keys
    created in the Duvo dashboard.


    ## Rate limits


    Requests are counted per API key. Every response advertises the quota with
    the IETF RateLimit fields, so a client can self-throttle without waiting for
    a rejection:


    - `RateLimit-Policy: "default";q=<quota>;w=<window seconds>` — the policy in
    force: `q` requests per `w` seconds.

    - `RateLimit: "default";r=<remaining>;t=<seconds>` — the live state: `r`
    requests left, quota resetting in `t` seconds.

    - Read the quota from the headers rather than hard-coding it; it differs per
    environment.

    - The same numbers are also sent as `ratelimit-limit`, `ratelimit-remaining`
    and `ratelimit-reset`.


    Once the quota is exhausted the API answers `429 Too Many Requests` with
    `Retry-After` set to the seconds to wait; honor it instead of retrying
    immediately.
  version: 1.0.0
servers:
  - url: https://api.duvo.ai
    description: Production server
security: []
tags:
  - name: Runs
    description: Start, monitor, and manage agent runs (Runs in the Duvo UI)
  - name: Sandboxes
    description: Create sandboxes and upload files for agent runs
  - name: Queues
    description: Manage queues and their agent bindings
  - name: Cases
    description: Create, list, and manage cases and their labels within queues
  - name: Case Approvals
    description: Submit decisions on pending case approval requests issued by an agent run
  - name: Case Attachments
    description: Upload, list, download, and remove the files attached to a case
  - name: Automations
    description: >-
      List and manage automations — the workspace container that groups the
      agents and queues making up one end-to-end process
  - name: Agents
    description: Create and manage agents for automation workloads
  - name: Revisions
    description: Create and manage agent revisions — the underlying Setup for an Agent
  - name: Agent Folders
    description: Organize agents into folders
  - name: Agent Memory
    description: Read an agent's memory files (the Memory feature in the Duvo UI)
  - name: Suggestions
    description: >-
      List, apply, and dismiss an Agent's improvement suggestions (the
      suggestions inbox in the Duvo UI)
  - name: Notifications
    description: >-
      List, read, dismiss, and clear the authenticated user's team notifications
      (the Notification Center in the Duvo UI)
  - name: Schedules
    description: List schedules configured for an agent
  - name: Duvo Pulse
    description: >-
      Create, list, iterate on, and delete Duvo Pulse dashboards — live,
      agent-generated visualizations of your Duvo data
  - name: Case Triggers
    description: >-
      Configure case triggers that automatically dispatch agent runs (Runs in
      the Duvo UI) for cases added to a queue
  - name: Triggers
    description: >-
      Configure event triggers that start a Run automatically when an external
      event fires (e.g. an email arrives, a Linear issue is created, or a file
      changes in Google Drive)
  - name: Skills
    description: Manage team and system skills (reusable knowledge packs).
  - name: Files
    description: Manage team files.
  - name: Plugins
    description: Discover plugins that can be referenced from a revision.
  - name: Organizations
    description: Inspect organizations you belong to and the teams within them
  - name: Team
    description: Inspect the team and members associated with the API key
  - name: Invites
    description: >-
      Invite people to a team — one at a time or in bulk, scoped to a Clarity
      process or the whole team — and manage the team's shareable invite link
  - name: Integrations
    description: Browse the team's catalog of available integration types
  - name: Connections
    description: Manage your connected integrations
  - name: Credentials
    description: >-
      Manage logins (domain + username + password + TOTP) used by agents to sign
      in to websites and desktop applications, and attach them to assignment
      revisions
  - name: Secrets
    description: >-
      Manage env-var secrets injected into runs, and attach them to assignment
      revisions. Only metadata is exposed; values are never returned
  - name: Revision Integrations
    description: >-
      Attach integrations to assignment revisions, pin specific connections, and
      link queues
  - name: ClarityV2
    description: >-
      Manage Clarity v2 process snapshots, automation proposals, and the
      extra-capture-request follow-up loop
paths:
  /v2/queues/{queue_id}/resume:
    post:
      tags:
        - Queues
      summary: Resume Queue
      description: >-
        Resume a paused queue. Its pending cases start on the next dispatch,
        within the queue's concurrency limit. Resuming a queue that is not
        paused changes nothing. Only a builder or team admin, or someone whose
        case trigger on the queue is on, can resume it.
      operationId: resumeQueue
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: queue_id
          required: true
          description: The queue's unique identifier
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  queue:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      name:
                        type: string
                      description:
                        type: string
                        nullable: true
                      folder_id:
                        nullable: true
                        type: string
                        format: uuid
                      automation_id:
                        nullable: true
                        type: string
                        format: uuid
                      team_id:
                        type: string
                        nullable: true
                      created_at:
                        type: string
                      created_by:
                        nullable: true
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                            nullable: true
                          email:
                            type: string
                        required:
                          - id
                          - name
                          - email
                        additionalProperties: false
                      paused_at:
                        description: >-
                          When the queue was paused, or null while it runs. A
                          paused queue starts no new case: runs already in
                          progress finish, and its pending cases stay pending
                          until it is resumed.
                        nullable: true
                        type: string
                      paused_by:
                        description: >-
                          The user who paused the queue, or null while it runs
                          or when that user's profile is gone.
                        nullable: true
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                            nullable: true
                          email:
                            type: string
                        required:
                          - id
                          - name
                          - email
                        additionalProperties: false
                      has_approvals:
                        type: boolean
                      setup_status:
                        description: >-
                          Whether the Queue's route can take new cases right
                          now, and why not. Null only when it could not be
                          computed. Absent while the feature is not enabled for
                          the team.
                        nullable: true
                        type: object
                        properties:
                          status:
                            type: string
                            description: >-
                              `active` when the route can take new cases;
                              `inactive` when nothing starts them, by choice,
                              plan or demo; `deactivated` when the team reached
                              its usage limit; `needs_setup` when something on
                              the route must be added or fixed.
                            x-extensible-enum:
                              - active
                              - inactive
                              - deactivated
                              - needs_setup
                          reasons:
                            type: array
                            items:
                              type: object
                              properties:
                                reason:
                                  type: string
                                  description: >-
                                    Why the Queue is not active. `no_agent`,
                                    `routing_off`, `no_entitlement` and `demo`
                                    make it inactive; `usage_limit` deactivates
                                    it; `no_live_version`, `trigger_conflict`,
                                    `connection_missing` and `connection_broken`
                                    mean it needs setup.
                                  x-extensible-enum:
                                    - no_live_version
                                    - trigger_conflict
                                    - connection_missing
                                    - connection_broken
                                    - usage_limit
                                    - no_agent
                                    - routing_off
                                    - no_entitlement
                                    - demo
                                agents:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      id:
                                        type: string
                                        format: uuid
                                        description: The Agent's ID.
                                      name:
                                        type: string
                                        description: The Agent's current name.
                                    required:
                                      - id
                                      - name
                                    additionalProperties: false
                                  description: >-
                                    The Agents the reason concerns: the routed
                                    Agent, every Agent in a trigger conflict, or
                                    none.
                                connections:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      integration_type:
                                        type: string
                                        description: >-
                                          The Connection's catalog integration
                                          type, e.g. "gmail".
                                      custom_integration_id:
                                        nullable: true
                                        description: >-
                                          The custom Connection's ID, or null for
                                          a catalog Connection.
                                        type: string
                                        format: uuid
                                      name:
                                        type: string
                                        description: The Connection's name.
                                      personal:
                                        type: boolean
                                        description: >-
                                          True when the account is the runner's
                                          own personal account, which only that
                                          person can reconnect. False for a shared
                                          account, or when no account is set up.
                                    required:
                                      - integration_type
                                      - custom_integration_id
                                      - name
                                      - personal
                                    additionalProperties: false
                                  description: >-
                                    The Connections a `connection_missing` or
                                    `connection_broken` reason names. Empty for
                                    every other reason.
                              required:
                                - reason
                                - agents
                                - connections
                              additionalProperties: false
                            description: >-
                              Every reason the Queue is not active, needs-setup
                              reasons first, then deactivated, then inactive.
                              Empty when the Queue is active.
                          unchecked:
                            type: array
                            items:
                              type: string
                              x-extensible-enum:
                                - entitlement
                                - usage
                            description: >-
                              Inputs that could not be read just now, so cases
                              may be waiting for a reason not listed. Empty in
                              normal operation.
                        required:
                          - status
                          - reasons
                          - unchecked
                        additionalProperties: false
                    required:
                      - id
                      - name
                      - description
                      - folder_id
                      - created_at
                      - has_approvals
                    additionalProperties: false
                required:
                  - queue
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
                  answer_persisted:
                    type: boolean
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - field
                        - message
                      additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
                  answer_persisted:
                    type: boolean
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - field
                        - message
                      additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
                  answer_persisted:
                    type: boolean
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - field
                        - message
                      additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
                  answer_persisted:
                    type: boolean
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - field
                        - message
                      additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
                  answer_persisted:
                    type: boolean
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                      required:
                        - field
                        - message
                      additionalProperties: false
                required:
                  - error
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Get your API key from the Duvo dashboard.

````

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