kp0yi2k4.nx.link

{
  "parameters": [
    {
      "in": "path",
      "name": "session_id",
      "required": true,
      "schema": {
        "format": "uuid",
        "title": "Session Id",
        "type": "string"
      }
    },
    {
      "description": "Cursor: return messages after this message ID",
      "in": "query",
      "name": "after",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "format": "uuid",
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Cursor: return messages after this message ID",
        "title": "After"
      }
    },
    {
      "description": "Cursor: return messages before this message ID",
      "in": "query",
      "name": "before",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "format": "uuid",
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Cursor: return messages before this message ID",
        "title": "Before"
      }
    },
    {
      "description": "Maximum number of messages to return (max 100).",
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "default": 10,
        "description": "Maximum number of messages to return (max 100).",
        "maximum": 100,
        "minimum": 1,
        "title": "Limit",
        "type": "integer"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "hasMore": {
                "description": "Whether there are more messages available beyond this page. Use cursor-based pagination with the `after` or `before` query parameters to fetch more.",
                "title": "Hasmore",
                "type": "boolean"
              },
              "messages": {
                "description": "List of messages in chronological order.",
                "items": {
                  "description": "A single message from the session's message stream.\n\nMessages represent the agent's actions, observations, and decisions as it executes a task.",
                  "properties": {
                    "createdAt": {
                      "description": "When this message was created.",
                      "format": "date-time",
                      "title": "Createdat",
                      "type": "string"
                    },
                    "data": {
                      "description": "Raw message content. Format depends on the message type — may be plain text, JSON, or structured action data.",
                      "title": "Data",
                      "type": "string"
                    },
                    "hidden": {
                      "default": false,
                      "description": "Whether this message should be hidden from the user in a chat UI.",
                      "title": "Hidden",
                      "type": "boolean"
                    },
                    "id": {
                      "description": "Unique message identifier.",
                      "format": "uuid",
                      "title": "Id",
                      "type": "string"
                    },
                    "role": {
                      "description": "Message role: \"human\" for user-submitted tasks, \"ai\" for agent actions and responses.",
                      "title": "Role",
                      "type": "string"
                    },
                    "screenshotUrl": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Browser screenshot captured at the time of this message. Presigned URL, expires after 5 minutes.",
                      "title": "Screenshoturl"
                    },
                    "sessionId": {
                      "description": "ID of the session this message belongs to.",
                      "format": "uuid",
                      "title": "Sessionid",
                      "type": "string"
                    },
                    "summary": {
                      "default": "",
                      "description": "One-liner human-readable description of the message (e.g. \"Navigating to google.com\", \"Clicking element #5\"). Useful for building activity feeds.",
                      "title": "Summary",
                      "type": "string"
                    },
                    "type": {
                      "default": "",
                      "description": "Message category. Common values: `user_message`, `assistant_message`, `browser_action`, `file_operation`, `code_execution`, `integration`, `planning`, `completion`, `browser_action_result`, `browser_action_error`.",
                      "title": "Type",
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "sessionId",
                    "role",
                    "data",
                    "createdAt"
                  ],
                  "title": "MessageResponse",
                  "type": "object"
                },
                "title": "Messages",
                "type": "array"
              }
            },
            "required": [
              "messages",
              "hasMore"
            ],
            "title": "MessageListResponse",
            "type": "object"
          }
        }
      },
      "description": "Successful Response"
    },
    "422": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "detail": {
                "items": {
                  "properties": {
                    "loc": {
                      "items": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "integer"
                          }
                        ]
                      },
                      "title": "Location",
                      "type": "array"
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  },
                  "required": [
                    "loc",
                    "msg",
                    "type"
                  ],
                  "title": "ValidationError",
                  "type": "object"
                },
                "title": "Detail",
                "type": "array"
              }
            },
            "title": "HTTPValidationError",
            "type": "object"
          }
        }
      },
      "description": "Validation Error"
    }
  }
}