# What is a Task?

---

A **Task** is a piece of work you hand to an AI coding agent. You describe what you want; it writes the code, checks it, and opens a **pull request for each repository** it touched.

You review a pull request like any other. Nothing lands without you.

## What you get back

A branch and a pull request per repository, with commits describing what changed and why. Repositories the agent didn't need to touch are left alone — no empty pull requests.

The diff lives in GitHub, GitLab or Bitbucket, where you already review code. Deployment.io shows you progress, logs and a link.

## It checks its own work

Before finishing, the agent runs your build and tests and fixes what it can.

This matters more than it sounds: **if those checks fail, nothing is committed and no pull request appears.** The Task fails instead. You review working code, or you review nothing.

## One at a time

Tasks run one at a time, in the order you created them. Start three and they'll queue — the first runs, the rest wait their turn.

## Two ways to start one

**Create one directly** when you already know what you want. See [Creating and Running a Task](/docs/tasks/creating-and-running-a-task/).

**Work it out in a session first**, then convert it — the Task arrives in your backlog for review before it runs. See [From Spec to Task](/docs/assistant/from-spec-to-task/).

You can also create Tasks from your own coding agent — see [Available MCP Tools](/docs/coding-agents/available-mcp-tools/).

Still deciding? A [session](/docs/assistant/what-is-a-session/) works out what to do. A Task does it.

---

Source: https://deployment.io/docs/tasks/what-is-a-task/