---
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
  - `bucket_name` string, required
  - `crawl_id` string, required
  - `url` string, required
  - `engines` EngineType[], required
  - `depth` integer
  - `stealth` boolean
  - `absolute_only` boolean
  - `keep_external` boolean
  - `visit_external` boolean
  - `max_workers` integer
  - `batch_size` integer
  - `max_urls` integer

## Response `200`

Successful Response

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

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-20** `1e457ec99343` — 1 info
  - added the new optional request property `stealth`
- **2025-08-12** `707c0eb9cee1` — 3 breaking, 5 info
  - request property `engines/items/` was restricted to a list of enum values
  - the `engines` request property's minItems was increased to `1`
  - the `engines/items/` request property type changed from `object` to `string`
  - added the new `FLEET` enum value to the request property `engines/items/`
  - …4 more

[Change 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/1e457ec99343/schema)