provider agent-tasks GET
/agents/tasks/{task_id} @utdk/github
/agents/tasks/{task_id} Get a task by ID
> [!NOTE]
> This endpoint is in public preview and is subject to change.
Returns a task by ID with its associated sessions
**Fine-grained access tokens for "Get a task by ID"**
This endpoint works with the following fine-grained token types:
* [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)
* [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)
The fine-grained token must have the following permission set:
* "Agent tasks" repository permissions (read)
GitHub App installation access tokens are not supported for this endpoint.
- task_id path required
- The unique identifier of the task.
- string
Try it
Authentication
Configure credentials for GitHub v3 REST API
Code snippet
Updates live as you fill in the form above.
TypeScript
import github from '@utdk/github';
await github.agentTasks.getTaskById()