---
title: "POST /sessions/{sessionIdentifier}/invocationSteps/{invocationStepId}"
method: POST
path: "/sessions/{sessionIdentifier}/invocationSteps/{invocationStepId}"
---

# POST /sessions/{sessionIdentifier}/invocationSteps/{invocationStepId}

`POST /sessions/{sessionIdentifier}/invocationSteps/{invocationStepId}`

Retrieves the details of a specific invocation step within an invocation in a session. For more information about sessions, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/sessions.html">Store and retrieve conversation history and context with Amazon Bedrock sessions</a>.

## Path parameters

- `invocationStepId` string, required
- `sessionIdentifier` string, required

## Request body

- object
  - `invocationIdentifier` string, required — The unique identifier for the invocation in UUID format.

## Response `200`

Success

- GetInvocationStepResponse
  - `invocationStep` object, required — The complete details of the requested invocation step.
    - `invocationId` string, required — The unique identifier (in UUID format) for the invocation that includes the invocation step.
    - `invocationStepId` string, required — The unique identifier (in UUID format) for the invocation step.
    - `invocationStepTime` string, date-time, required — The timestamp for when the invocation step was created.
    - `payload` object, required — Payload content, such as text and images, for the invocation step.
      - `contentBlocks` BedrockSessionContentBlock[] — The content for the invocation step.
        - `image` object — The image in the invocation step.
          - `format` 'png' | 'jpeg' | 'gif' | 'webp', required — The format of the image.
          - `source` object, required — The source for the image.
            - `bytes` string — The raw image bytes for the image. If you use an Amazon Web Services SDK, you don't need to encode the image bytes in base64.
            - `s3Location` object — The path to the Amazon S3 bucket where the image is stored.
              - …
        - `text` string — The text in the invocation step.
    - `sessionId` string, required — The unique identifier of the session containing the invocation step.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

[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)