---
title: "Pause a routine"
method: POST
path: "/routines/{id}/pause"
tags: ["Routines"]
---

# Pause a routine

`POST /routines/{id}/pause`

## Request

- Base URL: `https://elicit.com/api/v2`
- URL: `https://elicit.com/api/v2/routines/{id}/pause`
- Auth: HTTP bearer

Pauses an active routine and removes its scheduled occurrences. A run already in progress is not cancelled.

## Path parameters

- `id` string, uuid, required: Routine ID returned by a routine list or create response.

## Response `200`

The paused routine.

- RoutineResponse
  - `routine` Routine, required: A recurring Research Agent instruction. Archival is represented by a non-null removedAt rather than a separate status value.
    - `id` string, uuid, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `name` string, required
    - `status` 'active' | 'paused', required
    - `pauseReason` union, required
      - 'scheduler_projection_failed' | 'task_owner_lost_access' | 'session_unavailable' | 'session_owner_ineligible' | 'owner_plan_ineligible' | 'invalid_configuration'
      - string
    - `removedAt` string, nullable, required
    - `removedReason` 'user' | 'session_removed' | 'session_deleted' | 'null', nullable, required
    - `sessionId` string, required
    - `instruction` string, required
    - `schedule` object, required
      - `cadence` 'daily' | 'weekly', required
      - `dayOfWeek` integer, nullable, required
      - `runAtLocalTime` string, required
      - `timeZone` string, required
    - `ownerNotificationLevel` 'all_runs' | 'output_or_attention' | 'attention_only', required

## Other responses

- `400`: A path ID, query parameter, body field, schedule, cursor, or filter/sort combination is invalid.
- `401`: Authentication failed. The API key is missing, invalid, revoked, or expired.
- `403`: API access or routines are unavailable, or your role does not allow this action.
- `404`: The routine or requested session does not exist or is not accessible to you.
- `409`: The routine state changed, does not allow this operation, its session cannot run agent work, or another immediate run is already pending. Check the error code before retrying.
- `429`: Rate limit exceeded. More than 100 requests per minute were received from your IP address; further requests are blocked for 5 minutes.
- `500`: An unexpected error occurred. Retry reads with backoff; before retrying a write, check whether it took effect. See Error Handling for retry guidance.

## Changes

- **2026-10-13** `27c80b9a3470`: 6 info
  - added the optional property `error/details` to the response with the `400` status
  - added the optional property `error/details` to the response with the `401` status
  - added the optional property `error/details` to the response with the `403` status
  - added the optional property `error/details` to the response with the `404` status
  - …2 more
- **2026-10-02** `f9a4c55b1cde`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elicit/apis/elicit-api/changes/routines/:id/pause/post.md)

---

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