workflows
Get one drip workflow
GET /v1/workflows/{id}
Auth required
api.workflows.view
One workflow definition (metadata only) with its by-status run tally.
Path parameters
id string<uuid> required Resource UUID. An unparseable id reads as a clean 404 not_found.
Responses
Errors follow the RFC 7807 problem format — see the error reference.
200 The workflow definition application/json
id string<uuid> required name string required key string required The workflow's stable slug within the org.
description string optional status string required Lifecycle status: draft, active, paused, archived, or invalid.
invalid_reason string optional Present only when status is invalid.
require_send_approval boolean optional When true, sends are held for manual review instead of dispatching automatically.
current_version integer required The live definition version.
origin string enum required managed (authored in-app) or git (defined in a connected repo, read-only).
One of: managed, git
source_path string optional Repo-relative path of the .flow file (git-backed only).
source_url string optional "Edit in provider" deep link (git-backed only).
run_counts object required By-status run tally, e.g. active/completed → counts. Always present.
created_at string<date-time> required updated_at string<date-time> required 401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json