> ## 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.

# DELETE /api/files/{fileId}/places

> The person takes a file out of one place; out of its last place it goes to Trash.



## OpenAPI

````yaml /api/worksong.openapi.json delete /api/files/{fileId}/places
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/files/{fileId}/places:
    delete:
      tags:
        - Files
      summary: DELETE /api/files/{fileId}/places
      description: >-
        The person takes a file out of one place; out of its last place it goes
        to Trash.
      operationId: delete_api_files_fileId_places
      parameters:
        - name: fileId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                to:
                  type: string
                  enum:
                    - chat
                    - group
                    - task
                    - project
                    - agent
                    - kept
                    - link
                    - work
                conversationId:
                  type: string
                  format: uuid
                roomId:
                  type: string
                  format: uuid
                taskId:
                  type: string
                  format: uuid
                projectKey:
                  type: string
                  minLength: 1
                  maxLength: 120
                  pattern: ^[\p{L}\p{N}][\p{L}\p{N}._-]*$
                botId:
                  type: string
                  format: uuid
                workItemId:
                  type: string
                  format: uuid
                expiresInDays:
                  type: integer
                  minimum: 1
                  maximum: 365
              required:
                - to
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  file:
                    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
                      origin:
                        default: upload
                        type: string
                        enum:
                          - upload
                          - agent
                      sha256:
                        default: null
                        anyOf:
                          - type: string
                            pattern: ^[0-9a-f]{64}$
                          - type: 'null'
                      madeBy:
                        type: object
                        properties:
                          kind:
                            type: string
                            enum:
                              - person
                              - agent
                              - outside
                          botId:
                            default: null
                            anyOf:
                              - type: string
                                format: uuid
                              - type: 'null'
                          botName:
                            default: null
                            anyOf:
                              - type: string
                                maxLength: 200
                              - type: 'null'
                          source:
                            default: null
                            anyOf:
                              - type: string
                                enum:
                                  - web
                                  - whatsapp
                              - type: 'null'
                        required:
                          - kind
                          - botId
                          - botName
                          - source
                        additionalProperties: false
                      places:
                        type: array
                        items:
                          type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - chat
                                - group
                                - task
                                - project
                                - agent
                                - kept
                                - link
                            conversationId:
                              default: null
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                            roomId:
                              default: null
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                            taskId:
                              default: null
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                            projectKey:
                              default: null
                              anyOf:
                                - type: string
                                  maxLength: 200
                                - type: 'null'
                            botId:
                              default: null
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                            label:
                              default: null
                              anyOf:
                                - type: string
                                  maxLength: 200
                                - type: 'null'
                            addedByBotId:
                              default: null
                              anyOf:
                                - type: string
                                  format: uuid
                                - type: 'null'
                            addedByBotName:
                              default: null
                              anyOf:
                                - type: string
                                  maxLength: 200
                                - type: 'null'
                            addedAt:
                              type: string
                              format: date-time
                            linkExpiresAt:
                              default: null
                              anyOf:
                                - type: string
                                  format: date-time
                                - type: 'null'
                            origin:
                              default: false
                              type: boolean
                          required:
                            - kind
                            - conversationId
                            - roomId
                            - taskId
                            - projectKey
                            - botId
                            - label
                            - addedByBotId
                            - addedByBotName
                            - addedAt
                            - linkExpiresAt
                            - origin
                          additionalProperties: false
                      trashedAt:
                        default: null
                        anyOf:
                          - type: string
                            format: date-time
                          - type: 'null'
                    required:
                      - id
                      - filename
                      - mimeType
                      - byteSize
                      - available
                      - createdAt
                      - origin
                      - sha256
                      - madeBy
                      - places
                      - trashedAt
                    additionalProperties: false
                  link:
                    default: null
                    anyOf:
                      - type: object
                        properties:
                          url:
                            type: string
                            format: uri
                          expiresAt:
                            anyOf:
                              - type: string
                                format: date-time
                              - type: 'null'
                        required:
                          - url
                          - expiresAt
                        additionalProperties: false
                      - type: 'null'
                required:
                  - file
                  - link
                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.