{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n\n**Fine-grained access tokens for \"List tasks\"**\n\nThis endpoint works with the following fine-grained token types:\n\n* [GitHub App user access tokens](https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)\n* [Fine-grained personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token)\n\nThe fine-grained token must have the following permission set:\n\n* \"Agent tasks\" repository permissions (read)\n\nGitHub App installation access tokens are not supported for this endpoint.\n","properties":{"query":{"type":"object","properties":{"per_page":{"type":"integer","default":30,"minimum":1,"maximum":100,"description":"The number of results per page (max 100)."},"page":{"type":"integer","default":1,"minimum":1,"description":"The page number of the results to fetch."},"sort":{"type":"string","default":"updated_at","enum":["updated_at","created_at"],"description":"The field to sort results by. Can be `updated_at` or `created_at`."},"direction":{"type":"string","default":"desc","enum":["asc","desc"],"description":"The direction to sort results. Can be `asc` or `desc`."},"state":{"type":"string","description":"Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`."},"is_archived":{"type":"boolean","default":false,"description":"Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`."},"since":{"type":"string","format":"date-time","description":"Only show tasks updated at or after this time (ISO 8601 timestamp)"}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"List tasks","id":"github.agent-tasks.list-tasks","example":{},"maxRequests":1,"summary":false}}