---
title: "Create an idempotent points-account crawl"
method: POST
path: "/api/v1/tasks"
tags: ["Tasks"]
---

# Create an idempotent points-account crawl

`POST /api/v1/tasks`

## Request

- Base URL: `https://xcatcher.top`
- URL: `https://xcatcher.top/api/v1/tasks`
- Auth: HTTP bearer

## Request body

- CrawlRequest
  - `users` string[], required
  - `mode` 'normal' | 'deep'
  - `idempotency_key` string: API-key path only. Reuse for retries of identical intent.

## Response `200`

Created or idempotently replayed

- AnyJson

## Other responses

- `400`: Invalid input
- `402`: Insufficient points
- `409`: Idempotency conflict

---

[API](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api.md) · [All operations](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api/revisions/855ba4646e5a?raw)