---
title: "Create Project"
method: POST
path: "/api/v1/projects"
---

# Create Project

`POST /api/v1/projects`

## Request

- Base URL: `https://api.mesharc.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mesharc.dev/api/v1/projects`
- Auth: none declared

## Headers

- `authorization` string, nullable
- `x-mesharc-tenant` string, nullable

## Request body

- ProjectCreate
  - `seed` string, required
  - `name` string, nullable
  - `schedule` string
  - `retention` string
  - `config` ProjectConfig
    - `max_pages` integer, nullable
    - `max_depth` integer, nullable
    - `use_sitemap` boolean, nullable
    - `sitemap_mode` string, nullable
    - `sitemaps` string[], nullable
    - `sitemap_include` string[], nullable
    - `sitemap_exclude` string[], nullable
    - `crawl_mode` string, nullable
    - `sitemap_incremental` boolean, nullable
    - `sitemap_full_every` integer, nullable
    - `allow_browser` boolean, nullable
    - `keep_pages` boolean, nullable
    - `use_proxy` boolean, nullable
    - `include_paths` string[], nullable
    - `exclude_paths` string[], nullable
    - `include_tags` string[], nullable
    - `exclude_tags` string[], nullable
    - `preserve_tags` string[], nullable
    - `only_main_content` boolean, nullable
    - `strip_boilerplate` boolean, nullable
    - `strip_base64` boolean, nullable
    - `min_words` integer, nullable
    - `languages` string[], nullable
    - `respect_robots` boolean, nullable
    - `allow_subdomains` boolean, nullable
    - `breadth_per_level` integer, nullable
    - `crawl_delay_ms` integer, nullable
    - `concurrency` integer, nullable
    - `actions` object[], nullable
    - `actions_on` string, nullable
    - `actions_paths` string[], nullable
    - `llm_extract` object, nullable
    - `fetch_timeout_ms` integer, nullable
    - `fetch_retries` integer, nullable
    - `user_agent` string, nullable
    - `render_js` string, nullable
    - `max_tier` string, nullable
    - `googlebot` boolean, nullable
    - `solve_captcha` boolean, nullable
    - `max_credits_per_page` integer, nullable
    - `max_credits_per_run` integer, nullable
    - `max_credits_per_month` integer, nullable
    - `geo` string, nullable
    - `cache_max_age_hours` integer, nullable
    - `max_age_hours` integer, nullable
    - `force_cache` boolean, nullable
    - `parse_documents` boolean, nullable
    - `wait_for_selector` string, nullable
    - `wait_ms` integer, nullable
    - `viewport` string, nullable
    - `formats` string[], nullable
    - `json_schema` object[], nullable
    - `rows` object, nullable
    - `heading_style` string, nullable
    - `link_style` string, nullable
    - `image_mode` string, nullable
    - `image_exclude` string[], nullable
    - `image_min_width` integer, nullable
    - `image_min_height` integer, nullable
    - `image_max_kb` integer, nullable
    - `alt_fallback` string, nullable
    - `url_list` string[], nullable
    - `feeds` string[], nullable
    - `patterns` string[], nullable
    - `webhook_url` string, nullable
    - `webhook_events` string[], nullable
    - `notify_min_words` integer, nullable
    - `chat_url` string, nullable
    - `change_digest` object, nullable
    - `login_id` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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