---
search:
  tags:
    - Files
    - POST
seo:
  description: >-
    Begin a batch file upload transaction. Reference for the POST
    /v1/files/upload endpoint in the Roboto REST API.
sidebar:
  label: Begin upload
  badge: POST
title: Begin upload
type: openapi-operation
---
Begin a batch file upload transaction.

Creates file records in pending state and returns upload mappings
that specify where each file should be uploaded.

### Access control
 - requires_org
 - Restricted tokens need the API scope `files.import` or `files.upload`

`POST /v1/files/upload`