---
title: "POST /agents/agent-space/{agentSpaceId}/pendingMessages"
method: POST
path: "/agents/agent-space/{agentSpaceId}/pendingMessages"
---

# POST /agents/agent-space/{agentSpaceId}/pendingMessages

`POST /agents/agent-space/{agentSpaceId}/pendingMessages`

List pending messages for a specific execution.

## Path parameters

- `agentSpaceId` string, required — Unique identifier for an agent space (allows alphanumeric characters and hyphens; 1-64 characters)

## Request body

- object
  - `executionId` string, required — Generic resource identifier (allows alphanumeric characters, hyphens, and underscores; 1-128 characters)

## Response `200`

Success

- ListPendingMessagesResponse — Response structure containing a list of pending messages
  - `agentSpaceId` string, required — Unique identifier for an agent space (allows alphanumeric characters and hyphens; 1-64 characters)
  - `executionId` string, required — The unique identifier for the execution.
  - `messages` PendingMessage[], required — The list of pending messages for the execution.
    - `messageId` string, required — The unique identifier for this pending message.
    - `message` object, required — The message content.
      - `userMessage` UserMessageBlock[] — A message from the user.
        - `text` string — Text content from the user.
        - `toolResult` object — Tool execution result provided by the user.
      - `assistantMessage` AssistantMessageBlock[] — A message from the assistant.
        - `text` string — Text content from the assistant.
        - `toolUse` object — Tool use request from the assistant.
  - `createdAt` string, date-time, required — Timestamp when the pending messages were created.

## Other responses

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

---

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