Messages

----
-title: Messages
-url: https://platform.claude.com/docs/en/api/compliance/apps/sessions/local/messages
----
-
 # Messages
 
 ## Retrieve local session messages
 
-**get** `/v1/compliance/apps/sessions/local/{local_session_id}/messages`
+**GET** `/v1/compliance/apps/sessions/local/{local_session_id}/messages`
 
 Read one local session's transcript, oldest-first by default.
 

 honored for 24 hours: a cursor older than that is rejected with an
 explicit 400; restart the walk to read under the current boundary.
 
-### Path Parameters
+### Path parameters
 
 - `local_session_id: string`
 
-### Query Parameters
+### Query parameters
 
 - `limit: optional number`
 
   Maximum results (default: 100, max: 1000)
 
+  default: 100, maximum: 1000, minimum: 1
+
 - `order: optional "asc" or "desc"`
 
   Sort direction. `asc` (oldest-first, default) or `desc`.
 
+  default: asc
+
   - `"asc"`
 
   - `"desc"`

 
   Truncate each text item inside a tool result to at most this many bytes (cut on a code-point boundary). Pass `-1` to request the server maximum (approximately 1 MiB); larger values are clamped to it. `0` is not a valid value.
 
+  default: 10000, maximum: 2147483647, minimum: -1
+
 - `tool_use_input_max_bytes: optional number`
 
   Truncate each tool-use input to at most this many bytes (cut on a code-point boundary so the result is valid UTF-8). Pass `-1` to request the server maximum (approximately 1 MiB); larger values are clamped to it. `0` is not a valid value.
 
-### Header Parameters
+  default: 10000, maximum: 2147483647, minimum: -1
 
+### Headers
+
 - `"x-api-key": optional string`
 
 ### Returns
 
-- `data: array of object { id, content, created_at, 4 more }`
+- `data: array of object`
 
   Transcript turns for this page, in call order: oldest call first by default, newest call first with `order=desc`. The messages of one call carry the call's timestamp and follow each other in transcript order; a page boundary can fall between them.
 

 
     Message identifier, prefixed `clsm_`. Stable for as long as the message's turn is retained: identifiers of retained turns do not change as older turns age out of the organization's retention period. The `retention_elapsed` placeholder's identifier is distinct from every retained turn's and changes only when further turns age out.
 
-  - `content: array of object { text, truncated, type }  or object { id, input, name, 2 more }  or object { content, is_error, name, 3 more }`
+  - `content: array of object or object or object`
 
     Content blocks within the message, discriminated on `type` (`text` / `tool_use` / `tool_result`: the same discriminator values as the claude.ai chat-messages endpoint; the tool variants omit `integration_name` and `mcp_server_url`, and `text` carries `truncated`). Extended-thinking content is never included. The request's `system` field is never included; a presence-only marker message is emitted when it was set. The request's `tools[]` definitions are never included as transcript messages. Project-level instructions (such as CLAUDE.md files) appear in the message stream as a user-role context block and are included. Empty when `provenance.type` is `content_unavailable`.
 
-    - `Text object { text, truncated, type }`
+    - `Text object`
 
       Text content block.
 

 
         True when `text` was shortened by the server's fixed per-string bound (approximately 1 MiB), or when ancillary content the block carried (such as citations) was omitted, or when this block stands in for a non-text block whose content is not shown, or when it is an explanatory marker the server inserted (its text enclosed in square brackets, e.g. prefacing client-asserted history). There is no request parameter that raises the per-string bound.
 
+        default: false
+
       - `type: "text"`
 
-        - `"text"`
+        default: text
 
-    - `ToolUse object { id, input, name, 2 more }`
+    - `ToolUse object`
 
       Tool invocation requested by the assistant.
 

 
         True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request the server maximum.
 
+        default: false
+
       - `type: "tool_use"`
 
-        - `"tool_use"`
+        default: tool_use
 
-    - `ToolResult object { content, is_error, name, 3 more }`
+    - `ToolResult object`
 
       Result returned by a tool invocation.
 
-      - `content: array of object { text, type }`
+      - `content: array of object`
 
         Text content returned by the tool. Non-text item types are omitted and signalled via `truncated` with an in-band item-count marker.
 

 
         - `type: "text"`
 
-          - `"text"`
+          default: text
 
       - `is_error: boolean`
 

 
         True when one or more text items in `content` were shortened or non-text items were omitted. Pass `tool_result_max_bytes=-1` to request the server maximum.
 
+        default: false
+
       - `type: "tool_result"`
 
-        - `"tool_result"`
+        default: tool_result
 
   - `created_at: string`
 
     When the message was recorded (RFC 3339, UTC)
 
+    format: date-time
+
   - `model: string or null`
 
     The model that served this assistant turn, as reported in the `model` field of the underlying Messages API response. Null on user messages and on any assistant message whose `provenance` is set: client-asserted history and synthetic markers were not produced by a model during this session, and for unavailable content the serving model is not known.
 
-  - `provenance: object { reason, type }  or object { type }  or object { type }  or null`
+  - `provenance: object or object or object or null`
 
     Where this turn's content came from, discriminated on `type`. Null (the common case) means verified content: on an assistant message, content Claude produced during this session; on a user message, content the user sent. `content_unavailable`: the turn's content cannot be returned and `content` is empty; `reason` says why. `client_asserted`: assistant content the client supplied as conversation history; `content` shows what the model received but its authorship is not verified; never on user-role messages. `synthetic_marker`: a transcript marker the endpoint generated rather than content either party sent during the session. Both `client_asserted` and `synthetic_marker` can result from normal request or client processing, not only client modification. Callers should tolerate unrecognized `type` values.
 
-    - `ContentUnavailable object { reason, type }`
+    - `ContentUnavailable object`
 
       The turn's content cannot be returned; `content` is empty.
 

 
       - `type: "content_unavailable"`
 
-        - `"content_unavailable"`
+        default: content_unavailable
 
-    - `ClientAsserted object { type }`
+    - `ClientAsserted object`
 
       Assistant content the client supplied as conversation history
       rather than produced by Claude during this session. `content` shows

 
       - `type: "client_asserted"`
 
-        - `"client_asserted"`
+        default: client_asserted
 
-    - `SyntheticMarker object { type }`
+    - `SyntheticMarker object`
 
       A transcript marker generated by the endpoint rather than sent by
       either party during the session. Marker messages indicate that the

 
       - `type: "synthetic_marker"`
 
-        - `"synthetic_marker"`
+        default: synthetic_marker
 
   - `role: "assistant" or "user"`
 

 
   - `type: "compliance_local_session_message"`
 
-    - `"compliance_local_session_message"`
+    default: compliance_local_session_message
 
 - `next_page: string or null`
 
   Opaque pagination cursor (prefixed `page_`) for the next page. Null when there is no further page. Treat as an opaque string; the format may change without notice.
 
-- `session: object { id, created_at, organization_uuid, 5 more }`
+- `session: object`
 
   The local session the messages belong to. `user.email_address` is always null on this endpoint; the messages endpoint does not resolve email addresses.
 

 
     Timestamp of the session's first retained inference call (RFC 3339, UTC). When a session's activity spans the child organization's retention boundary, calls older than the boundary are no longer reflected, so this value is the timestamp of the earliest retained call: always strictly after the boundary, never the boundary itself.
 
+    format: date-time
+
   - `organization_uuid: string`
 
     UUID of the child organization the session belongs to

 
   - `type: "compliance_local_session"`
 
-    - `"compliance_local_session"`
+    default: compliance_local_session
 
   - `updated_at: string`
 
     Timestamp of the session's last retained inference call (RFC 3339, UTC). Always at or after `created_at`. When a session's activity spans the child organization's retention boundary, calls older than the boundary are no longer reflected — but because retention removes only the oldest calls, this value (unlike `created_at`) is unaffected until the entire session has aged out. On the list endpoint this value is a lower bound: for a session still active at a page or `created_at.lt` window boundary it can momentarily lag the session's true last activity. Retrieving the session, or its messages, always reflects the exact latest retained call.
 
-  - `user: object { id, email_address }`
+    format: date-time
 
+  - `user: object`
+
     The authenticated user at the time of the session. Always set; `user.id` is always populated. `user.email_address` is null when the user's account has been deleted or the user is no longer a member of an organization the key may read.
 
     - `id: string`

 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/compliance/apps/sessions/local/$LOCAL_SESSION_ID/messages \
     -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

 }
 ```
 
-## Domain Types
+## Domain types
 
 ### Message List Response
 
-- `MessageListResponse object { id, content, created_at, 4 more }`
+- `MessageListResponse object`
 
   A single user or assistant turn in a local session transcript.
 

 
     Message identifier, prefixed `clsm_`. Stable for as long as the message's turn is retained: identifiers of retained turns do not change as older turns age out of the organization's retention period. The `retention_elapsed` placeholder's identifier is distinct from every retained turn's and changes only when further turns age out.
 
-  - `content: array of object { text, truncated, type }  or object { id, input, name, 2 more }  or object { content, is_error, name, 3 more }`
+  - `content: array of object or object or object`
 
     Content blocks within the message, discriminated on `type` (`text` / `tool_use` / `tool_result`: the same discriminator values as the claude.ai chat-messages endpoint; the tool variants omit `integration_name` and `mcp_server_url`, and `text` carries `truncated`). Extended-thinking content is never included. The request's `system` field is never included; a presence-only marker message is emitted when it was set. The request's `tools[]` definitions are never included as transcript messages. Project-level instructions (such as CLAUDE.md files) appear in the message stream as a user-role context block and are included. Empty when `provenance.type` is `content_unavailable`.
 
-    - `Text object { text, truncated, type }`
+    - `Text object`
 
       Text content block.
 

 
         True when `text` was shortened by the server's fixed per-string bound (approximately 1 MiB), or when ancillary content the block carried (such as citations) was omitted, or when this block stands in for a non-text block whose content is not shown, or when it is an explanatory marker the server inserted (its text enclosed in square brackets, e.g. prefacing client-asserted history). There is no request parameter that raises the per-string bound.
 
+        default: false
+
       - `type: "text"`
 
-        - `"text"`
+        default: text
 
-    - `ToolUse object { id, input, name, 2 more }`
+    - `ToolUse object`
 
       Tool invocation requested by the assistant.
 

 
         True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request the server maximum.
 
+        default: false
+
       - `type: "tool_use"`
 
-        - `"tool_use"`
+        default: tool_use
 
-    - `ToolResult object { content, is_error, name, 3 more }`
+    - `ToolResult object`
 
       Result returned by a tool invocation.
 
-      - `content: array of object { text, type }`
+      - `content: array of object`
 
         Text content returned by the tool. Non-text item types are omitted and signalled via `truncated` with an in-band item-count marker.
 

 
         - `type: "text"`
 
-          - `"text"`
+          default: text
 
       - `is_error: boolean`
 

 
         True when one or more text items in `content` were shortened or non-text items were omitted. Pass `tool_result_max_bytes=-1` to request the server maximum.
 
+        default: false
+
       - `type: "tool_result"`
 
-        - `"tool_result"`
+        default: tool_result
 
   - `created_at: string`
 
     When the message was recorded (RFC 3339, UTC)
 
+    format: date-time
+
   - `model: string or null`
 
     The model that served this assistant turn, as reported in the `model` field of the underlying Messages API response. Null on user messages and on any assistant message whose `provenance` is set: client-asserted history and synthetic markers were not produced by a model during this session, and for unavailable content the serving model is not known.
 
-  - `provenance: object { reason, type }  or object { type }  or object { type }  or null`
+  - `provenance: object or object or object or null`
 
     Where this turn's content came from, discriminated on `type`. Null (the common case) means verified content: on an assistant message, content Claude produced during this session; on a user message, content the user sent. `content_unavailable`: the turn's content cannot be returned and `content` is empty; `reason` says why. `client_asserted`: assistant content the client supplied as conversation history; `content` shows what the model received but its authorship is not verified; never on user-role messages. `synthetic_marker`: a transcript marker the endpoint generated rather than content either party sent during the session. Both `client_asserted` and `synthetic_marker` can result from normal request or client processing, not only client modification. Callers should tolerate unrecognized `type` values.
 
-    - `ContentUnavailable object { reason, type }`
+    - `ContentUnavailable object`
 
       The turn's content cannot be returned; `content` is empty.
 

 
       - `type: "content_unavailable"`
 
-        - `"content_unavailable"`
+        default: content_unavailable
 
-    - `ClientAsserted object { type }`
+    - `ClientAsserted object`
 
       Assistant content the client supplied as conversation history
       rather than produced by Claude during this session. `content` shows

 
       - `type: "client_asserted"`
 
-        - `"client_asserted"`
+        default: client_asserted
 
-    - `SyntheticMarker object { type }`
+    - `SyntheticMarker object`
 
       A transcript marker generated by the endpoint rather than sent by
       either party during the session. Marker messages indicate that the

 
       - `type: "synthetic_marker"`
 
-        - `"synthetic_marker"`
+        default: synthetic_marker
 
   - `role: "assistant" or "user"`
 

 
   - `type: "compliance_local_session_message"`
 
-    - `"compliance_local_session_message"`
+    default: compliance_local_session_message