# Start an upload over the tus protocol

`POST /assets/tus` · Rivier · files

Start an upload over the tus protocol; the address answered carries a grant a browser can send the bytes with.

- Scope: files:write
- Sdk: files.upload.tus
- Cli: files upload tus

## Responses

- `201`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X POST 'https://api.rivier.ai/assets/tus' \
  -H 'Authorization: Bearer $KEY'
```