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

# POST /api/bots/{botId}/tasks/{taskId}/unarchive



## OpenAPI

````yaml /api/worksong.openapi.json post /api/bots/{botId}/tasks/{taskId}/unarchive
openapi: 3.1.0
info:
  title: Worksong API
  version: 042e65d5f227
  description: >-
    The HTTP API behind the Worksong apps, generated from the code at the commit
    below. Request and response shapes come from the shared zod contract; an
    operation marked `x-gaps` has a part the generator could not resolve.
  x-source: worksong-ai/worksong@042e65d5f2275493f60f879c7970dcfdeceb7e0e
servers:
  - url: https://app.worksong.ai
security:
  - bearerAuth: []
tags:
  - name: Approvals
  - name: Audit
  - name: Avatar generator
  - name: Bootstrap
  - name: Bot compute limit
  - name: Bot mcp servers
  - name: Bots
  - name: Calls
  - name: Connections
  - name: Contacts
  - name: Conversations
  - name: Coupons
  - name: Day grants
  - name: Desktop
  - name: Entity files
  - name: Files
  - name: Github
  - name: Insights
  - name: Login
  - name: Mcp servers
  - name: Me
  - name: Me bot messaging
  - name: Me chat header
  - name: Me daily limit
  - name: Me time zone
  - name: Memory
  - name: Message delete
  - name: Messages
  - name: Notifications
  - name: Optimize prompt
  - name: Phone
  - name: Places
  - name: Projects
  - name: Public file links
  - name: Push
  - name: Queue
  - name: Reactions
  - name: Register
  - name: Rooms
  - name: Routes
  - name: Routines
  - name: Runs
  - name: Skills
  - name: Tasks
  - name: Transcribe
  - name: Tts
  - name: Webhooks
  - name: Whats new
  - name: Whatsapp
  - name: Workspace files
paths:
  /api/bots/{botId}/tasks/{taskId}/unarchive:
    post:
      tags:
        - Tasks
      summary: POST /api/bots/{botId}/tasks/{taskId}/unarchive
      operationId: post_api_bots_botId_tasks_taskId_unarchive
      parameters:
        - name: botId
          in: path
          required: true
          schema:
            type: string
        - name: taskId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  number:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 2147483647
                  botId:
                    type: string
                    format: uuid
                  title:
                    type: string
                    minLength: 1
                    maxLength: 200
                  description:
                    type: string
                    maxLength: 20000
                  status:
                    type: string
                    enum:
                      - pending
                      - queued
                      - in_progress
                      - waiting
                      - blocked
                      - resuming
                      - completed
                      - failed
                      - cancelled
                  progress:
                    type: string
                    maxLength: 20000
                  result:
                    anyOf:
                      - type: string
                        maxLength: 100000
                      - type: 'null'
                  blockedReason:
                    anyOf:
                      - type: string
                        maxLength: 4000
                      - type: 'null'
                  originatingConversationId:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                  originatingSessionId:
                    anyOf:
                      - type: string
                        minLength: 1
                        maxLength: 200
                        pattern: ^[A-Za-z0-9._:-]+$
                      - type: 'null'
                  originatingRunId:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                  workConversationId:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                  startedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  completedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  lastActivityAt:
                    type: string
                    format: date-time
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
                  artifacts:
                    default: []
                    maxItems: 16
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        filename:
                          type: string
                          minLength: 1
                          maxLength: 255
                        mimeType:
                          type: string
                          minLength: 1
                          maxLength: 128
                        byteSize:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        available:
                          type: boolean
                        createdAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - filename
                        - mimeType
                        - byteSize
                        - available
                        - createdAt
                      additionalProperties: false
                  escalation:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                          cycle:
                            type: integer
                            minimum: 1
                            maximum: 9007199254740991
                          reason:
                            type: string
                            minLength: 1
                            maxLength: 4000
                          attempts:
                            type: string
                            minLength: 1
                            maxLength: 20000
                          userActionRequired:
                            type: string
                            minLength: 1
                            maxLength: 4000
                          context:
                            anyOf:
                              - type: string
                                maxLength: 20000
                              - type: 'null'
                          checkpoint:
                            type: object
                            properties:
                              workConversationId:
                                anyOf:
                                  - type: string
                                    format: uuid
                                  - type: 'null'
                              workSessionId:
                                anyOf:
                                  - type: string
                                    minLength: 1
                                    maxLength: 200
                                    pattern: ^[A-Za-z0-9._:-]+$
                                  - type: 'null'
                              workRunId:
                                anyOf:
                                  - type: string
                                    format: uuid
                                  - type: 'null'
                              transcriptSeq:
                                anyOf:
                                  - type: integer
                                    minimum: 0
                                    maximum: 9007199254740991
                                  - type: 'null'
                              originatingConversationId:
                                anyOf:
                                  - type: string
                                    format: uuid
                                  - type: 'null'
                            required:
                              - workConversationId
                              - workSessionId
                              - workRunId
                              - transcriptSeq
                              - originatingConversationId
                            additionalProperties: false
                          resolution:
                            anyOf:
                              - type: string
                                maxLength: 20000
                              - type: 'null'
                          escalatedAt:
                            type: string
                            format: date-time
                          resolvedAt:
                            anyOf:
                              - type: string
                                format: date-time
                              - type: 'null'
                        required:
                          - id
                          - cycle
                          - reason
                          - attempts
                          - userActionRequired
                          - context
                          - checkpoint
                          - resolution
                          - escalatedAt
                          - resolvedAt
                        additionalProperties: false
                      - type: 'null'
                  resumeAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                  createdBy:
                    type: string
                    enum:
                      - agent
                      - user
                  review:
                    anyOf:
                      - type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - pending
                              - approved
                              - changes_requested
                          decidedAt:
                            anyOf:
                              - type: string
                                format: date-time
                              - type: 'null'
                        required:
                          - state
                          - decidedAt
                        additionalProperties: false
                      - type: 'null'
                  archivedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: 'null'
                required:
                  - id
                  - botId
                  - title
                  - description
                  - status
                  - progress
                  - result
                  - blockedReason
                  - originatingConversationId
                  - originatingSessionId
                  - originatingRunId
                  - workConversationId
                  - startedAt
                  - completedAt
                  - lastActivityAt
                  - createdAt
                  - updatedAt
                  - artifacts
                additionalProperties: false
        4XX:
          description: Error. A problem object with a status and a message.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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