Update a pipeline

patch

https://hivemind.hr/api/public/v1/pipelines/{id}

Mutable subset only: name and status. active is read-only and
derived from status; sending it returns 400.

Status transitions

Allowed via API:

active → inactive (pause; ATS write-back when role is filled)
active → draft (send back to editing in the UI)
same-state PATCH (no-op)

Rejected:

any → active → 422 pipeline_activation_via_ui_only (UI must
validate node graph + form)
draft → anything → 422 pipeline_in_draft (drafts may be
incomplete)
inactive → anything → 422 invalid_status_transition
(reactivate via UI)

name is patchable from any status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

required

Pipeline UUID.

Body Params

At least one mutable field is required. active is rejected
deliberately — set status instead. Status transitions are
enforced; see PATCH /pipelines/:id for the full matrix.

name

string

length ≤ 256

status

string

enum

Whitelisted to draft and inactive only. active is
intentionally absent — pipelines must be activated in the UI
so the node graph and form configuration are validated.

Allowed:

Headers

Idempotency-Key

string

^[A-Za-z0-9_-]{8,64}$

Optional. Send the same key on a retry to make the request
idempotent. The first successful 2xx response is cached for
24 hours; subsequent retries with the same key return the
cached response with Idempotent-Replay: true. Reusing a key
with a different request body returns 409
idempotency_conflict. Format: 8–64 chars of [A-Za-z0-9_-]
— a UUID v4 is a fine default.

Responses

200The refreshed pipeline.

400Validation failure (no fields, sent active, bad status enum).

401Missing, malformed, or invalid API key.

404Pipeline not found OR belongs to a different company. We return 404 in both cases to avoid leaking row existence across tenants.

422Disallowed status transition (see endpoint description).

429Rate limit exceeded. Retry after Retry-After seconds.

500Unexpected server-side error. Log the request_id and contact support.