---
title: "Create Request"
method: POST
path: "/workflows/request/crawl"
tags: ["workflows"]
---

# Create Request

`POST /workflows/request/crawl`

Make a request to temporal worker
:param request: crawl request data
:param token_data: api token
:return: response

## Request body

- CrawlRequest
  - `crawl_id` string, required
  - `url` string, required
  - `engines` EngineType[], required
  - `depth` integer
  - `stealth` boolean
  - `camo` boolean
  - `absolute_only` boolean
  - `keep_external` boolean
  - `visit_external` boolean
  - `max_workers` integer
  - `batch_size` integer
  - `max_urls` integer
  - `proxy_url` string, nullable
  - `proxy_username` string, nullable
  - `proxy_password` string, nullable
  - `teardown` boolean
  - `session_id` string, nullable
  - `agentic` boolean
  - `wait_until` 'domcontentloaded' | 'load' | 'networkidle' | 'commit' — When to consider page load complete for web scraping operations

## Response `200`

Successful Response

- WorkflowResult
  - `url` string, required
  - `workflow_id` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-19** `666e807fc6d8` — 2 info
  - added the new optional request property `proxy_password`
  - added the new optional request property `proxy_username`
- **2026-02-17** `29225d7b3ea4` — 1 warning, 2 info
  - removed the request property `bucket_name`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-11-07** `46e7585b14b5` — 1 breaking, 1 info
  - removed `#/components/schemas/cartography__models__WaitUntil` from the `wait_until` request property `anyOf` list
  - added `#/components/schemas/WaitUntil` to the `wait_until` request property `anyOf` list
- **2025-11-07** `e0272b0f7e0a` — 1 info
  - added the new optional request property `wait_until`
- **2025-11-06** `d7ed14ab37e8` — 1 warning
  - removed the request property `wait_until`

[Full history](https://skmtc.dev/evrimai/apis/cartography-server/changes/workflows/request/crawl/post.md)

---

[API](https://skmtc.dev/evrimai/apis/cartography-server.md) · [All operations](https://skmtc.dev/evrimai/apis/cartography-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evrimai/cartography-server/revisions/5ee44bc43d24/schema)