REST API reference · Source channels

Upload a file requested by a successful business submission¶

Use only the expiring upload URL returned by business creation.

POST/source-channels/{source_channel_id}/business-files/{upload_id}/

Parameters¶

Name	Location	Type	Required
`source_channel_id`	path	string	Yes
`upload_id`	path	string	Yes
`Idempotency-Key`	header	string	Yes

Request body¶

Send a body that matches the published schema.

View request schema

{
  "additionalProperties": false,
  "properties": {
    "file": {
      "format": "binary",
      "type": "string"
    }
  },
  "required": [
    "file"
  ],
  "type": "object"
}

Request¶

curl --request POST \
  --url 'https://api.staging.levr.ai/api/external/v1/source-channels/{source_channel_id}/business-files/{upload_id}/' \
  --header 'Authorization: Bearer $LEVR_API_TOKEN' \
  --header 'Idempotency-Key: $IDEMPOTENCY_KEY' \
  --header 'Content-Type: multipart/form-data' \
  --data '@request.json'

Responses¶

Status	Description
`201`	File stored on the requested application field.
`400`	Correct the request fields and try again.
`401`	Provide a valid portal API token and try again.
`403`	This portal API token does not allow the requested action.
`404`	The requested resource was not found or is not available to this token.
`409`	The request conflicts with the resource's current state. Refresh it before trying again.
`413`	The request was not completed.
`429`	Too many requests were sent. Wait before trying again.
`500`	Levr could not complete the request. Keep the request ID and retry when safe.