> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slaunt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Task tools: create, search and import Slaunt Tasks

> Parameters and record shape for tasks_log, tasks_recent, tasks_search, tasks_get, tasks_import_github and tasks_import_linear.

Tasks track work that isn't finished yet, with a status that changes over time. Use them for follow-ups an agent can't do now, blockers, or work pulled in from GitHub and Linear. Importing the same upstream item again updates the existing task rather than duplicating it, so imports are safe to re-run.

## Task shape

```json theme={null}
{
  "id": "bc9260be-ae5f-4c71-9b47-92c557e4d65b",
  "title": "Publish thread title capture PR",
  "summary": "Implementation ready; blocked on repository access.",
  "description": "...",
  "status": "blocked",
  "assignee_user_id": null,
  "tags": ["threads"],
  "source": { "type": "agent", "item_type": "task", "item_id": null, "url": null, "repo": "acme/web", "project_key": null, "actor": "Jane Doe", "raw_event": null },
  "created_at": "2026-10-25T01:19:47.187+00:00",
  "updated_at": "2026-10-25T01:19:47.187+00:00"
}
```

Responses currently also include internal fields (`org_id`, `project`, `created_by`, `origin`, `embedding`). Don't build on them.

| Field | Values |
| - | - |
| `status` | `open`, `triaged`, `in_progress`, `blocked` count as active (plan limit); `resolved`, `closed`, `cancelled` don't |
| `source.type` | `manual`, `agent`, `github`, `linear` |

## tasks\_log

| Param | |
| - | - |
| `title` | **Required** |
| `summary` | For GitHub/Linear sources, generated from `source.raw_event` if omitted |
| `description` | |
| `status` | Default `open` |
| `assignee_user_id` | UUID; find it with `workspace_people_list` |
| `tags` | |
| `source` | `type` (default `manual`), `item_type`, `item_id`, `url`, `repo`, `project_key`, `actor`, `raw_event` |

## Reading tasks

| Tool | Params |
| - | - |
| `tasks_recent` | `status`, `source_type`, `limit` 1–100 (default 20) |
| `tasks_search` | `query` **required**, `status`, `source_type`, `limit` 1–100 (default 10). Semantic, like `ccr_search`. |
| `tasks_get` | `id` **required** |

## tasks\_import\_github

Useful for turning CI failures into tracked work, not just issues and PRs.

| Param | |
| - | - |
| `owner`, `repo` | **Required** |
| `category` | **Required:** `issues`, `pull_requests`, `workflow_failures`, `deployment_failures`, `test_failures` |
| `state` | `open` (default), `closed`, `all` |
| `per_page` | 1–100 (default 20) |
| `page` | 1–50 |

## tasks\_import\_linear

| Param | |
| - | - |
| `category` | **Required:** `issues`, `initiatives` |
| `team_key` | Limit to one Linear team |
| `limit` | 1–100 (default 20) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.