---
title: "POST /teams/{teamID}/boards/{boardID}/files"
method: POST
path: "/teams/{teamID}/boards/{boardID}/files"
---

# POST /teams/{teamID}/boards/{boardID}/files

`POST /teams/{teamID}/boards/{boardID}/files`

## Request

- Base URL: `http://localhost/api/v2`
- URL: `http://localhost/api/v2/teams/{teamID}/boards/{boardID}/files`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/mattermost/apis/focalboard-server/docs/teams/:teamID/boards/:boardID/files/post.ts> (a function with typed inputs; its response is checked against the schema)

Upload a binary file, attached to a root block

## Path parameters

- `teamID` string, required
- `boardID` string, required

## Request body `multipart/form-data`

- object
  - `uploaded file` string, binary: The file to upload

## Response `200`

success

- unknown

## Other responses

- `404`: board not found
- `default`: internal error

## Changes

- **2022-04-13** `8e122d5d731c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mattermost/apis/focalboard-server/changes/teams/:teamID/boards/:boardID/files/post.md)

---

[API](https://skmtc.dev/mattermost/apis/focalboard-server.md) - [All operations](https://skmtc.dev/mattermost/apis/focalboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/mattermost/apis/focalboard-server/revisions/d238428e1666?raw)