# Upload AWS document ID

Associates an AWS identification reference to an issued disposable certificate. Used when a video identification process stores evidence on AWS.
See [uploadAwsId](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-documents).

Endpoint: POST /api/document/{lraId}/uploadAwsId
Version: 26.1.0.3
Security: basicAuth, sslCertificate

## Security:

  - `basicAuth` (unknown)
    http basic

  - `sslCertificate` (unknown)
    mutualTLS

## Path parameters:

  - `lraId` (string, required)
    Local Registration Authority (LRA) identifier.

## Request fields (application/json):

  - `awsId` (string, required)
    AWS identification reference for the video identification evidence.
    Example: HgI1MM8VuxpoXh6xozcd0gU8rPCvUN6c9HJRY27-K9A2hRm9ZVFFsVx2whuohH63

  - `deviceCode` (string, required)
    Device code of the issued certificate, returned by `enroll` (`deviceCode`).
    Example: RHIDP0000000000000

  - `idOtp` (integer, required)
    OTP certificate identifier returned by `enroll` (`certIdOtp`).
    Example: 1234567

  - `externalKey` (string)
    Optional external reference key.
    Example: external_key_sample

## Response 200:

  - `200` (unknown)
    AWS ID uploaded successfully. Response body is empty.

## Response 500:

  - `500` (unknown)
    Application error. The backend returns HTTP 500 for all application errors, including validation failures and authentication errors.

## Response 500 fields (application/json):

  - `code` (integer, required)
    Application error code.
    Example: 242

  - `message` (string, required)
    Human-readable error description. For validation errors (code 242), includes field-level details in the format `Input parameter invalid: [{field=..., message=...}]`.
    Example: Input parameter invalid: [{field=disposableHolder, message=must not be null}]

## Response 500 examples:

  - `Missing required fields (code 242)` (unknown)

  - `Invalid deviceCode/idOtp pair (code 85)` (unknown)

  - `Authentication or authorization error (code 11002)` (unknown)

