action microsoft_list_folder_messages {
  label: "List folder messages"
  description: "List messages in a specific mail folder. Well-known folder names like inbox, drafts, sentitems, and deleteditems work as the folder id."
  provider: microsoft
  method: GET
  path: "/v1.0/me/mailFolders/{folder_id}/messages"
  scopes: ["Mail.ReadWrite"]
  input: @json {
    {
      "type": "object",
      "required": ["folder_id"],
      "additionalProperties": false,
      "properties": {
        "folder_id": { "type": "string", "description": "Folder id or well-known name, e.g. inbox." },
        "$top": { "type": "integer", "description": "Maximum number of messages to return." },
        "$skip": { "type": "integer", "description": "Number of messages to skip for paging." },
        "$filter": { "type": "string", "description": "OData filter, e.g. isRead eq false." },
        "$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" }
            }
          }
        },
        "@odata.nextLink": { "type": "string" }
      }
    }
  }
}