# Upload file to a task

Required scopes: task-management:write

Endpoint: POST /tasks/{id}/upload
Version: v1
Security: http, oauth2

## Path parameters:

  - `id` (string, required)

## Query parameters:

  - `find_by` (string)
    The field to search by
    Enum: "id", "uri", "external_id"

  - `origin` (string)
    Used if find_by=external_id  by default it will use the integration slug

## Request fields (multipart/form-data):

  - `file` (string, required)
    File to upload - Max: 15MB

## Response 200 fields (application/json):

  - `id` (string, required)

  - `file_name` (string, required)

  - `mime_type` (string, required)

  - `size` (integer, required)
    File size in bytes

  - `entity_id` (string, required)
    ID of the entity that the file belongs to

  - `entity_type` (string, required)
    Type of the entity that the file belongs to

  - `created_at` (string, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.