List Workflows

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Daily Data Sync",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-20T14:45:00Z",
      "description": "Workflow to sync daily sales data from CRM to warehouse",
      "runs_count": 152,
      "last_run_at": "2024-04-20T14:00:00Z",
      "last_run_status": "completed"
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-04-20T15:00:00Z"
  },
  "pagination": {
    "limit": 1,
    "total": 25,
    "next": "https://api.onepin.ai/api/v1/workflows?offset=1&limit=1",
    "prev": null
  }
}

List workflows in the current workspace.

Multi-sort: sort and order are parallel lists. ?sort=runs_count&sort=name&order=desc&order=asc orders primarily by runs_count DESC, secondarily by name ASC. When order is shorter than sort, missing entries default per-field: name=asc, updated_at=desc, runs_count=desc. When sort is omitted, list defaults to updated_at DESC. Every sort path appends Workflow.id ASC as a deterministic tiebreaker for pagination stability.

paused is accepted but currently returns an empty result because backend pause state is not implemented. last_run_status is the raw RunStatus value, including values like pending or cancelled, and pagination total is the filtered total for the current query.

List workflows in the current workspace. Multi-sort: `sort` and `order` are parallel lists. `?sort=runs_count&sort=name&order=desc&order=asc` orders primarily by runs_count DESC, secondarily by name ASC. When `order` is shorter than `sort`, missing entries default per-field: `name=asc, updated_at=desc, runs_count=desc`. When `sort` is omitted, list defaults to `updated_at DESC`. Every sort path appends `Workflow.id ASC` as a deterministic tiebreaker for pagination stability. `paused` is accepted but currently returns an empty result because backend pause state is not implemented. `last_run_status` is the raw RunStatus value, including values like `pending` or `cancelled`, and pagination `total` is the filtered total for the current query.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Query parameters

statusenum or nullOptional

UI workflow status filter. paused is accepted for forward compatibility and currently returns no rows.

Allowed values:

searchstring or nullOptional<=100 characters

Case-insensitive search over name and description.

sortlist of enums or nullOptional

Repeat for multi-sort. Pairs with order index-wise.

Allowed values:

orderlist of enums or nullOptional

Parallel to sort[]; shorter is padded with per-field defaults.

Allowed values:

last_run_afterdatetime or nullOptional

Filter workflows whose last_run_at is at or after this ISO datetime.

last_run_beforedatetime or nullOptional

Filter workflows whose last_run_at is at or before this ISO datetime.

offsetintegerOptional>=0Defaults to 0

limitintegerOptional1-100Defaults to 20

Response

Successful Response

datalist of objects

metaobject

paginationobject

PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

422

Unprocessable Entity Error

List workflows in the current workspace.

$	curl https://api.onepin.ai/api/v1/workflows \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Headers

Query parameters

Response

Errors