---
title: "Start session"
method: POST
path: "/v4/crawl/start"
tags: ["Crawler"]
---

# Start session

`POST /v4/crawl/start`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v4/crawl/start`
- Auth: API key in header `x-api-key`

Start a new crawling session with an existing configuration

## Request body

- StartSessionWithConfigRequest: Schema for starting a session with an existing configuration
  - `configId` string, required: Configuration ID to use for this session

## Response `200`

200

- StartCrawlerSessionResponse: Response schema for starting a crawling session
  - `message` string, required: Response message
  - `sessionId` string, required: Session ID
  - `configId` string: Config ID (included when creating config and starting session)
  - `error` string, nullable, required: Error message if any

## Other responses

- `400`: 400
- `401`: 401
- `404`: 404
- `500`: 500

---

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