---
title: "Initialise upload"
method: POST
path: "/api/upload/init"
tags: ["Step 2 Initialise upload"]
---

# Initialise upload

`POST /api/upload/init`

## Request

- Base URL: `https://your-bynder-domain`
- URL: `https://your-bynder-domain/api/upload/init`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://your-bynder-domainDefaultValue/`
    - Client credentials
    - Token URL: `https://your-bynder-domainDefaultValue/token` scopes: `MEDIAUPLOAD`, `MEDIAUPLOADFORAPPROVAL`
  - API key in header `Authorization`

Initialise an upload.

## Headers

- `Content-Type` 'application/x-www-form-urlencoded', required

## Request body `application/x-www-form-urlencoded`

- object
  - `filename` string

## Response `200`

Successful response

- ApiUploadInitResponse
  - `multipart_params` MultipartParams
    - `Content-Type` string
    - `Policy` string
    - `X-Amz-Signature` string
    - `acl` string
    - `key` string
    - `success_action_status` string
    - `x-amz-algorithm` string
    - `x-amz-credential` string
    - `x-amz-date` string
  - `s3_filename` string
  - `s3file` S3file
    - `targetid` string
    - `uploadid` string
  - `target_key` string

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/bynder/apis/upload-assets.md) - [All operations](https://skmtc.dev/bynder/apis/upload-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/upload-assets/revisions/05062b65fc98?raw)