---
title: "Prepare the upload"
url: "https://earlyaccess.developers.bynder.com/apis/modern-stack-file-upload-1/versions/6d6cce94-280c-448d-a782-cc8e300b2ccc/paths/v7-file_cmds-upload-prepare/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/modern-stack-file-upload-1/versions/6d6cce94-280c-448d-a782-cc8e300b2ccc.md

# Prepare the upload

`POST` `/v7/file_cmds/upload/prepare`

Prepare the upload of a file in chunks.

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Successful response
- `400` - Bad request

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Modern Stack File Upload
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
    variables:
      your-bynder-domain:
        default: example.com
        description: Your Bynder domain.
paths:
  /v7/file_cmds/upload/prepare:
    post:
      description: Prepare the upload of a file in chunks.
      requestBody:
        content:
          application/json:
            schema:
              type: object
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                properties:
                  file_id:
                    description: File ID to be used in subsequent upload steps.
                    example: 00000000-0000-0000-0000-000000000000
                    type: string
                type: object
          description: Successful response
        "400":
          description: Bad request
      summary: Prepare the upload
      tags:
        - Step 1
security:
  - permanentToken: []
  - OAuth2: []
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```