# Upload a project file

`POST /v1/projects/{projectId}/files`

Required OAuth scopes: `projects:write` and `files:write`

## Parameters

- `projectId` (path, string (uuid), required)

## Request body

- `file` (string (binary), required)

## Responses

- `201`
  - `file` (object, required)
    - `id` (string, required)
    - `versionId` (string (uuid))
    - `name` (string, required)
    - `mediaType` (string, required)
    - `size` (number, required)
    - `taskId` (string | null, required)
    - `projectId` (string | null, required)
    - `downloadUrl` (string (uri), required)
    - `createdAt` (string, required)
    - `updatedAt` (string, required)
- `400`: Invalid request
- `401`: Missing or invalid Bearer credential
- `402`: Payment or subscription required
- `403`: Credential is missing a required scope
- `404`: Resource not found
- `409`: Request conflict
- `429`: Rate limit exceeded
- `500`: Internal API error