---
title: "POST /journal/agent-space/{agentSpaceId}/journalRecords"
method: POST
path: "/journal/agent-space/{agentSpaceId}/journalRecords"
---

# POST /journal/agent-space/{agentSpaceId}/journalRecords

`POST /journal/agent-space/{agentSpaceId}/journalRecords`

List journal records 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)
  - `limit` integer — Maximum number of records to return in a single response (1-100, default: 100)
  - `nextToken` string — Pagination token for list operations (1-2048 characters)
  - `recordType` string — Filter records by type (empty string returns all types)
  - `order` 'ASC' | 'DESC' — Sort order options for journal operations

## Response `200`

Success

- ListJournalRecordsResponse — Response structure containing a list of journal records
  - `records` JournalRecord[], required — List of journal records matching the request criteria
    - `agentSpaceId` string, required — The unique identifier for the agent space containing this record
    - `executionId` string, required — The execution ID associated with this journal record
    - `recordId` string, required — The unique identifier for this journal record
    - `content` object, required — The content of this journal record
    - `createdAt` string, date-time, required — Timestamp when this journal record was created
    - `recordType` string, required — The type of this journal record
    - `userReference` object — Reference to the user associated with this journal record
      - `userId` string, required — The unique identifier for the user
      - `userType` 'IAM' | 'IDC' | 'IDP', required — The type of user
  - `nextToken` string — Token for retrieving the next page of results, if more results are available

## Other responses

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

---

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