> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete schedule

> Permanently removes a schedule from NATS, Mongo, and the Redis cache.

Permanently removes a schedule in a single call.

See [Agent Schedules](/docs/agents/agent-schedules#lifecycle-semantics) for cascade behaviour on agent deletion.

<RequestExample>
  ```bash Delete theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X DELETE https://api.orq.ai/v3/agents/customer_digest/schedules/01KPN29WWKSK0VDPJNTKZPVNRB \
    -H "Authorization: Bearer $ORQ_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```text 204 No Content theme={"theme":{"light":"github-light","dark":"github-dark"}}
  ```

  ```json 404 Not Found theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "error": {
      "code": "schedule_not_found",
      "message": "Schedule not found"
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml delete /v3/agents/{agent_key}/schedules/{schedule_id}
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v3/agents/{agent_key}/schedules/{schedule_id}:
    delete:
      tags:
        - Agent Schedules
      summary: Delete schedule
      description: Permanently removes a schedule from NATS, Mongo, and the Redis cache.
      operationId: delete-agent-schedule
      parameters:
        - description: The unique routing key of the agent the schedule belongs to.
          in: path
          name: agent_key
          required: true
          schema:
            description: The unique routing key of the agent the schedule belongs to.
            type: string
        - description: The schedule's ULID, as returned from create.
          in: path
          name: schedule_id
          required: true
          schema:
            description: The schedule's ULID, as returned from create.
            type: string
      responses:
        '204':
          description: Schedule deleted.
        '404':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  error:
                    $ref: '#/components/schemas/PublicScheduleErrorDetail'
                required:
                  - error
                type: object
          description: Schedule not found, or belongs to a different agent.
components:
  schemas:
    PublicScheduleErrorDetail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable error code, e.g. invalid_expression, schedule_not_found,
            agent_not_found.
          type: string
        message:
          description: Human-readable error description.
          type: string
      required:
        - code
        - message
      type: object
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````