# Data upload endpoint for inbound files to Adra Suite

**POST /api/v3.0/{engagementSid}/files/{inboundFileCategory}/{suggestedFileName}**

Upload a file to the Integration Hub for processing in Adra Suite. This endpoint supports various file types depending on the inboundFileCategory.

### File Size Limits
- Maximum file size: 100 MB

### Required Headers
- `Authorization`: Bearer token for authentication
- `User-Agent`: Client identifier
- `Content-Length`: File size in bytes

### Optional Headers
- `Content-Type`: File MIME type
- `Last-Modified`: File's last modification timestamp

### Processing
After upload, the file will be:
1. Validated for format and content
2. Queued for processing
3. Processed according to the inboundFileCategory

Use the status endpoint to track the processing status using the returned uniqueFileName.


## Servers
- Production server: https://integrationhub.adra.com (Production server)


## Authentication methods
- Adra personal access token & Adra oauth code pkce & Adra oauth client cred


## Parameters
### Headers
- **User-Agent** (string)
  A string that enables identifying the client. Logic-Apps, Boomi, Postman, and other integration tools add this automatically. (required)
- **Content-Length** (integer(int64))
  The number of bytes for the file being uploaded (required)
- **x-gw-stloc-hint** (string)
  Optional HTTP header to optimize request routing and reduce latency. Possible values: EUWE-01 (West Europe), AUEA-01 (Australia East), USEA-01 (East US), NO01 (Norway East).
- **Content-Type** (string)
  Upload file's content-type (optional)
- **Last-Modified** (string(date-time))
  Upload file's last modified date (optional)

### Path parameters
- **engagementSid** (string)
  Short identifier for engagement (as in URLs)
- **inboundFileCategory** (string)
  Specifies the category of the inbound file. Each category corresponds to a specific type of data being uploaded.
- **suggestedFileName** (string)
  The name of the file with extension


### Body: */* (string(binary))

string(binary)

## Responses
### 201
Created

#### Body: application/json (object)
- **uniqueFileName** (string)


### 400
Bad Request: see problem details for more information

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 401
Unauthorized: Missing an authorization header or token, or the token has expired

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 403
Forbidden: You don't have access to the engagement, the engagement doesn't have IH or you don't have IH access on the engagement, or the client is trying to access an unauthorized tenant resource

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 411
Length Required: The file length information needs to be provided

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 413
Payload Too Large: The file is too big, needs to be under 100 MB

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 500
Internal Server Error

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### default
Error

#### Body: application/problem+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)



[Powered by Bump.sh](https://bump.sh)