---
title: "Pause or Resume Source"
method: PATCH
path: "/api/v1/sources/{source_instance_id}/status"
tags: ["Sources"]
---

# Pause or Resume Source

`PATCH /api/v1/sources/{source_instance_id}/status`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/sources/{source_instance_id}/status`
- Auth: HTTP bearer

Pause or resume a created source. `source_instance_id` is the UUID returned by Create.

Set `status` to `paused` to stop an ongoing source's recurring runs, or `active` to resume it. Pausing stops the schedule (when present), disables provider webhooks where applicable (e.g. Stripe, TheirStack), and prevents further imports; resuming restarts them. Static / one-time sources have nothing recurring to pause, but the status still updates.

Returns the source's new public status.

## Path parameters

- `source_instance_id` string, uuid, required

## Request body

- PatchSourceStatusBody: Lifecycle control for the source.
  - `status` 'active' | 'paused', required: `paused` stops recurring runs; `active` resumes them.

## Response `200`

Default Response

- object
  - `status` integer
  - `data` PatchSourceStatusResponse: Confirmation of the source's new public lifecycle status.
    - `source_instance_id` string, required: The source instance UUID.
    - `status` 'active' | 'paused', required: The source's new public status (`active` or `paused`).

## Other responses

- `400`: Invalid `source_instance_id` or `status`.
- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `404`: Source not found (or not owned by the caller's org).
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

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