action microsoft_list_messages {
  label: "List messages"
  description: "List messages in the signed-in user's mailbox, newest first by default."
  provider: microsoft
  method: GET
  path: "/v1.0/me/messages"
  scopes: ["Mail.ReadWrite"]
  input: @json {
    {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "$top": { "type": "integer", "description": "Maximum number of messages to return (default 10)." },
        "$skip": { "type": "integer", "description": "Number of messages to skip for paging." },
        "$filter": { "type": "string", "description": "OData filter, e.g. isRead eq false." },
        "$search": { "type": "string", "description": "Search query wrapped in double quotes, e.g. \"subject:report\"." },
        "$select": { "type": "string", "description": "Comma-separated list of properties to return." },
        "$orderby": { "type": "string", "description": "Sort order, e.g. receivedDateTime desc." }
      }
    }
  }
  output: @json {
    {
      "type": "object",
      "additionalProperties": true,
      "properties": {
        "value": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
              "id": { "type": "string" },
              "subject": { "type": "string" },
              "bodyPreview": { "type": "string" },
              "from": { "type": "object" },
              "receivedDateTime": { "type": "string" },
              "isRead": { "type": "boolean" },
              "webLink": { "type": "string" }
            }
          }
        },
        "@odata.nextLink": { "type": "string" }
      }
    }
  }
}