> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# carrierClaimUploadCreate

> Start a file upload for a carrier claim, such as a damage photo, proof of purchase or the recipient's signed DHL affidavit, as a JPEG, PNG, GIF or PDF. PUT the file's raw bytes to the returned `url` before `expiresAt`, then pass `uploadId` in a file of `carrierClaimCreate`'s `evidence.files`. Each id works once. Counts against the account's file upload quota; over the quota returns THROTTLED.

**Required scopes:** [`carrier_claims_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-carrier_claims_write)

## Arguments

**input** `[CarrierClaimUploadCreateInput!](/docs/api-reference/v3/reference/returns/carrier-claim-upload-create-input)` *required*

The size of the file to upload.

**fields**

**byteSize** `Int!` *required*

The file's exact size in bytes, e.g. from `wc -c < photo.jpg`. At most 10000000. It is signed into the URL, so a file of any other size is rejected.

## Returns

**carrierClaimUploadCreate** `[CarrierClaimUpload!](/docs/api-reference/v3/reference/returns/carrier-claim-upload)` *required*

A private, one-time place to PUT a photo or document for a carrier claim, so its bytes never pass through the API request.

**fields**

**expiresAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When `url` stops accepting the file.

**uploadId** `String!` *required*

Pass as a file's `uploadId` in `carrierClaimCreate`'s `evidence` once the file is uploaded.

**url** `String!` *required*

Where to PUT the file's raw bytes, e.g. `curl --fail -X PUT --upload-file ./photo.jpg "<url>"`. No other headers are needed; curl sends the Content-Length the URL was signed for.

## Example

```graphql theme={null}
mutation {
  carrierClaimUploadCreate(input: { ... }) {
    expiresAt
    uploadId
    url
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.