> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # Update schedule > Update an existing schedule. Partial updates supported - only include fields to change. Note: Changing schedule_type (recurring ↔ one_time) is not supported; delete and recreate the schedule instead. ## OpenAPI ````yaml https://neo.api.projectdiscovery.io/api/openapi.json patch /api/v1/schedules/{id} openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events paths: /api/v1/schedules/{id}: patch: tags: - Schedules summary: Update schedule description: > Update an existing schedule. Partial updates supported - only include fields to change. Note: Changing schedule_type (recurring ↔ one_time) is not supported; delete and recreate the schedule instead. operationId: patch-v1-schedules-id parameters: - description: Schedule ID in: path name: id required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateScheduleRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/UpdateScheduleResponse' description: Schedule updated '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Schedule not found '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: UpdateScheduleRequest: properties: custom_weekdays: items: maximum: 6 minimum: 0 type: integer nullable: true type: array direct_agent_id: nullable: true type: string file_keys: items: type: string nullable: true type: array llm_model: $ref: '#/components/schemas/ModelType' name: maxLength: 256 type: string reporting_mode: description: >- Output reporting mode - 'full' returns all data (default), 'changes_only' generates a diff report. Omit the field to leave unchanged. enum: - full - changes_only type: string run_at: description: >- For one_time schedules - relative ("5m", "1h", "2d") or absolute ("14:30", "3:00PM") time. Required when changing to one_time. type: string scan_frequency: enum: - daily - weekly - monthly - custom type: string schedule_type: description: >- Change schedule type. Requires run_at when changing to one_time, or scan_frequency when changing to recurring. enum: - recurring - one_time type: string secrets: items: type: string nullable: true type: array start_time: description: Start time in HH:MM format (24h) nullable: true type: string task_message: minLength: 1 type: string type: object UpdateScheduleResponse: properties: schedule: properties: id: format: uuid type: string name: nullable: true type: string next_execution_at: format: date-time nullable: true type: string scan_frequency: nullable: true type: string status: enum: - active - paused - completed - failed type: string updated_at: format: date-time type: string type: object required: - schedule type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string required: - error type: object ModelType: description: | LLM model identifier. "auto" defers model selection to the agent, which picks per-request based on task complexity, cost, and security context. enum: - auto - opus-4.8 - opus-4.7 - opus-4.6 - sonnet-4.6 - haiku-4.5 - gpt-5.5-high - gpt-5.4-xhigh - gpt-5.4-high - gpt-5.3-codex-high - gemini-3-pro - gemini-3-flash - grok-4.3-high - grok-4.3-fast - kimi-k2.6 - glm-5 - glm-5.1 - glm-5.2 - deepseek-v4-pro-high type: string securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ````