---
search:
  tags:
    - Files
    - POST
seo:
  description: >-
    Begin a single file upload with a pre-signed URL. Reference for the POST
    /v1/files/signed_url_upload endpoint in the Roboto REST API.
sidebar:
  label: Begin signed url upload
  badge: POST
title: Begin signed url upload
type: openapi-operation
---
Begin a single file upload with a pre-signed URL.

Creates a file record in pending state and returns a pre-signed URL
that can be used to upload the file content directly.

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

`POST /v1/files/signed_url_upload`