---
title: "PUT /sessions/{sessionIdentifier}/invocations/"
method: PUT
path: "/sessions/{sessionIdentifier}/invocations/"
---

# PUT /sessions/{sessionIdentifier}/invocations/

`PUT /sessions/{sessionIdentifier}/invocations/`

Creates a new invocation within a session. An invocation groups the related invocation steps that store the content from a conversation. For more information about sessions, see [Store and retrieve conversation history and context with Amazon Bedrock sessions](https://docs.aws.amazon.com/bedrock/latest/userguide/sessions.html).

Related APIs

*   [ListInvocations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListInvocations.html)
    
*   [ListSessions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ListSessions.html)
    
*   [GetSession](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GetSession.html)

## Path parameters

- `sessionIdentifier` string, required

## Request body

- object
  - `description` string — A description for the interactions in the invocation. For example, "User asking about weather in Seattle".
  - `invocationId` string — A unique identifier for the invocation in UUID format.

## Response `201`

Success

- CreateInvocationResponse
  - `createdAt` string, date-time, required — The timestamp for when the invocation was created.
  - `invocationId` string, required — The unique identifier for the invocation.
  - `sessionId` string, required — The unique identifier for the session associated with the invocation.

## Other responses

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

---

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