---
title: "Start a task"
method: POST
path: "/v1/episodes"
tags: ["Tasks"]
---

# Start a task

`POST /v1/episodes`

## Request

- Base URL: `https://api.xzar.si`
- URL: `https://api.xzar.si/v1/episodes`
- Auth: HTTP bearer

Start an episode on a real decided case. Uses one task's credit ($2.00 self-serve). Returns the episode id, instructions and tool budget.

## Request body

- object
  - `taskset` string: patents-first-action (default), patents-response, patents-appeal or tariffs-classification
  - `task_id` string

## Response `200`

OK

- object

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Error

---

[API](https://skmtc.dev/xzar/apis/xzar-api.md) · [All operations](https://skmtc.dev/xzar/apis/xzar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xzar/apis/xzar-api/revisions/78d6801f117e?raw)