> ## 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.

# Create schedule

> Create a new scheduled or one-time task.

**Schedule Types:**
- `recurring`: Repeating schedule (daily, weekly, monthly, or custom)
- `one_time`: Single execution at specified time

**For recurring schedules:**
- `scan_frequency`: Required - one of daily, weekly, monthly, custom
- `start_time`: Optional - HH:MM format for when to run (default: current time)
- `custom_weekdays`: For custom - array of weekdays (0=Sunday, 6=Saturday)

**For one-time schedules:**
- `run_at`: Required - relative ("5m", "1h", "2d") or absolute ("14:30", "3:00PM") time




## OpenAPI

````yaml https://neo.api.projectdiscovery.io/api/openapi.json post /api/v1/schedules
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:
    post:
      tags:
        - Schedules
      summary: Create schedule
      description: >
        Create a new scheduled or one-time task.


        **Schedule Types:**

        - `recurring`: Repeating schedule (daily, weekly, monthly, or custom)

        - `one_time`: Single execution at specified time


        **For recurring schedules:**

        - `scan_frequency`: Required - one of daily, weekly, monthly, custom

        - `start_time`: Optional - HH:MM format for when to run (default:
        current time)

        - `custom_weekdays`: For custom - array of weekdays (0=Sunday,
        6=Saturday)


        **For one-time schedules:**

        - `run_at`: Required - relative ("5m", "1h", "2d") or absolute ("14:30",
        "3:00PM") time
      operationId: post-v1-schedules
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateScheduleRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateScheduleResponse'
          description: Schedule created
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    CreateScheduleRequest:
      properties:
        custom_weekdays:
          description: For custom frequency - array of weekdays (0=Sunday, 6=Saturday)
          items:
            maximum: 6
            minimum: 0
            type: integer
          type: array
        direct_agent_id:
          type: string
        file_keys:
          description: Optional file references
          items:
            type: string
          type: array
        llm_model:
          $ref: '#/components/schemas/ModelType'
        metadata:
          additionalProperties: true
          description: >-
            Optional metadata for delivery configuration (e.g., Slack channel
            info for posting results)
          type: object
        name:
          description: Human-readable schedule name
          maxLength: 256
          type: string
        project_id:
          description: >-
            Optional project ID to create a project-scoped schedule (requires
            project membership)
          format: uuid
          type: string
        reporting_mode:
          description: >-
            Output reporting mode - 'full' (default) returns all data,
            'changes_only' generates a diff report comparing current results
            with the previous execution
          enum:
            - full
            - changes_only
          type: string
        run_at:
          description: >-
            For one_time schedules - relative ("5m", "1h", "2d") or absolute
            ("14:30", "3:00PM") time
          type: string
        scan_frequency:
          description: Required for recurring schedules
          enum:
            - daily
            - weekly
            - monthly
            - custom
          type: string
        schedule_type:
          default: recurring
          enum:
            - recurring
            - one_time
          type: string
        secrets:
          description: Optional secret names to expose to each scheduled execution
          items:
            type: string
          type: array
        selected_visibility_type:
          enum:
            - public
            - private
            - team
          type: string
        source_task_id:
          description: The source task/chat ID that this schedule was created from (if any)
          type: string
        start_time:
          description: Start time in HH:MM format (24h)
          type: string
        task_message:
          description: The task message to execute
          minLength: 1
          type: string
      required:
        - task_message
      type: object
    CreateScheduleResponse:
      properties:
        schedule:
          properties:
            created_at:
              format: date-time
              type: string
            file_count:
              type: integer
            frequency_description:
              type: string
            has_files:
              type: boolean
            id:
              format: uuid
              type: string
            name:
              nullable: true
              type: string
            next_execution_at:
              format: date-time
              nullable: true
              type: string
            project_id:
              description: Project ID if this is a project-scoped schedule
              format: uuid
              nullable: true
              type: string
            scan_frequency:
              nullable: true
              type: string
            schedule_type:
              enum:
                - recurring
                - one_time
              type: string
            status:
              enum:
                - active
                - paused
                - completed
                - failed
              type: string
          required:
            - id
            - status
            - created_at
          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

````