---
title: "POST /async-invoke"
method: POST
path: "/async-invoke"
---

# POST /async-invoke

`POST /async-invoke`

Starts an asynchronous invocation.

This operation requires permission for the `bedrock:InvokeModel` action.

To deny all inference access to resources that you specify in the modelId field, you need to deny access to the `bedrock:InvokeModel` and `bedrock:InvokeModelWithResponseStream` actions. Doing this also denies access to the resource through the Converse API actions ([Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) and [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)). For more information see [Deny access for inference on specific models](https://docs.aws.amazon.com/bedrock/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-deny-inference).

## Request body

- object
  - `clientRequestToken` string — Specify idempotency token to ensure that requests are not duplicated.
  - `modelId` string, required — The model to invoke.
  - `modelInput` object, required — Input to send to the model.
  - `outputDataConfig` object, required — Asynchronous invocation output data settings.
    - `s3OutputDataConfig` object — A storage location for the output data in an S3 bucket
      - `s3Uri` string, required — An object URI starting with <code>s3://</code>.
      - `kmsKeyId` string — A KMS encryption key ID.
      - `bucketOwner` string — If the bucket belongs to another AWS account, specify that account's ID.
  - `tags` Tag[] — Tags to apply to the invocation.
    - `key` string, required — The tag's key.
    - `value` string, required — The tag's value.

## Response `200`

Success

- StartAsyncInvokeResponse
  - `invocationArn` string, required — The ARN of the invocation.

## Other responses

- `480` — AccessDeniedException
- `481` — ThrottlingException
- `482` — ResourceNotFoundException
- `483` — InternalServerException
- `484` — ServiceUnavailableException
- `485` — ValidationException
- `486` — ServiceQuotaExceededException
- `487` — ConflictException

---

[API](https://skmtc.net/aws/apis/bedrock-runtime.md) · [All operations](https://skmtc.net/aws/apis/bedrock-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-runtime/revisions/8a393198b636/schema)