---
title: "POST /2023-10-12/batch-get-session-action"
method: POST
path: "/2023-10-12/batch-get-session-action"
---

# POST /2023-10-12/batch-get-session-action

`POST /2023-10-12/batch-get-session-action`

Retrieves multiple session actions in a single request. This is a batch version of the `GetSessionAction` API.

The result of getting each session action is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

## Request body

- object
  - `identifiers` BatchGetSessionActionIdentifier[], required — The list of session action identifiers to retrieve. You can specify up to 100 identifiers per request.
    - `farmId` string, required — The farm ID of the session action.
    - `queueId` string, required — The queue ID of the session action.
    - `jobId` string, required — The job ID of the session action.
    - `sessionActionId` string, required — The session action ID.

## Response `200`

Success

- BatchGetSessionActionResponse
  - `sessionActions` BatchGetSessionActionItem[], required — A list of session actions that were successfully retrieved.
    - `farmId` string, required — The farm ID of the session action.
    - `queueId` string, required — The queue ID of the session action.
    - `jobId` string, required — The job ID of the session action.
    - `sessionActionId` string, required — The session action ID.
    - `status` 'ASSIGNED' | 'RUNNING' | 'CANCELING' | 'SUCCEEDED' | 'FAILED' | 'INTERRUPTED' | 'CANCELED' | 'NEVER_ATTEMPTED' | 'SCHEDULED' | 'RECLAIMING' | 'RECLAIMED', required — The status of the session action.
    - `startedAt` string, date-time — The date and time the resource started running.
    - `endedAt` string, date-time — The date and time the resource ended running.
    - `workerUpdatedAt` string, date-time — The date and time the resource was updated by a worker.
    - `progressPercent` number, float — The completion percentage for the session action.
    - `manifests` TaskRunManifestPropertiesResponse[] — The manifests for the session action.
      - `outputManifestPath` string — The manifest file path.
      - `outputManifestHash` string — The hash value of the file.
    - `sessionId` string, required — The session ID for the session action.
    - `processExitCode` integer — The exit code to apply to the session action.
    - `progressMessage` string, password — The message that communicates the progress of the session action.
    - `acquiredLimits` AcquiredLimit[] — The limits that were acquired for the session action.
      - `limitId` string, required — The unique identifier of the limit.
      - `count` integer, required — The number of limit resources used.
    - `definition` object, required — The session action definition.
      - `envEnter` object — The environment to enter into.
        - `environmentId` string, required — The environment ID.
      - `envExit` object — The environment to exit from.
        - `environmentId` string, required — The environment ID.
      - `taskRun` object — The task run in the session.
        - `taskId` string — The task ID.
        - `stepId` string, required — The step ID.
        - `parameters` object, required — The task parameters.
      - `syncInputJobAttachments` object — The session action definition for syncing input job attachments.
        - `stepId` string — The step ID for the sync input job attachments session action.
  - `errors` BatchGetSessionActionError[], required — A list of errors for session actions that could not be retrieved.
    - `farmId` string, required — The farm ID of the session action that could not be retrieved.
    - `queueId` string, required — The queue ID of the session action that could not be retrieved.
    - `jobId` string, required — The job ID of the session action that could not be retrieved.
    - `sessionActionId` string, required — The session action ID of the session action that could not be retrieved.
    - `code` 'InternalServerErrorException' | 'ResourceNotFoundException' | 'ValidationException', required — The error code.
    - `message` string, required — The error message.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ThrottlingException
- `483` — ValidationException

---

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