---
title: "Create Schedule"
method: POST
path: "/v1/schedules"
tags: ["scan-experience"]
---

# Create Schedule

`POST /v1/schedules`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/schedules`
- Auth: HTTP bearer

## Request body

- ScheduleScanRequest
  - `name` string, required
  - `target_id` string, required
  - `scan_mode` 'discovery_only' | 'authenticated_discovery' | 'authorization_matrix' | 'agent_analysis' | 'read_only_schema_fuzzing' | 'approved_state_changing_fuzzing' | 'full_staging_assessment', required
  - `cron_expression` string, required
  - `timezone` string
  - `journey_id` string, nullable
  - `auth_profile_id` string, nullable
  - `budget` RequestedBudget: Customer-requested ceilings bounded by platform hard limits.
    - `requests` integer
    - `browser_milliseconds` integer
    - `llm_microusd` integer
    - `storage_bytes` integer
  - `enabled` boolean

## Response `201`

Successful Response

- ScheduleRecord
  - `schedule_id` string, required
  - `tenant_id` string, required
  - `name` string, required
  - `target_id` string, required
  - `scan_mode` 'discovery_only' | 'authenticated_discovery' | 'authorization_matrix' | 'agent_analysis' | 'read_only_schema_fuzzing' | 'approved_state_changing_fuzzing' | 'full_staging_assessment', required
  - `cron_expression` string, required
  - `timezone` string, required
  - `journey_id` string, nullable
  - `auth_profile_id` string, nullable
  - `enabled` boolean, required
  - `created_by` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_enqueued_at` string, date-time, nullable
  - `last_enqueued_run_id` string, nullable
  - `next_run_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)