List accessible workflows

GET/api/v1/workflows

Authorization

AuthorizationRequiredBearer <token>

Steve API key, usually scoped to a company. Legacy keys and keys created by platform administrators may be unscoped; company-scoped endpoints reject unscoped keys with 403 Forbidden. Format: Authorization: Bearer aok_...

In: header

Query Parameters

cursorstring

Opaque pagination cursor returned by a previous response.

limitinteger

Page size. Steve clamps values to the range 1..100.

Default: 20Minimum: 1Maximum: 100

Header Parameters

X-Request-Idstring

Optional caller-supplied request identifier. Maximum length is 128 characters.

Maximum length: 128

curl -X GET "https://your-deployment.convex.site/api/v1/workflows?cursor=%3Cstring%3E&limit=20" \
  -H "X-Request-Id: <string>" \
  -H "Authorization: Bearer <token>"

Accessible workflows

{
  "data": [
    {
      "id": "string",
      "slug": "string",
      "name": "string",
      "description": "string",
      "icon": "string",
      "color": "string",
      "publishedVersion": 0,
      "contractUrl": "string",
      "upload": {
        "minFiles": 0,
        "maxFiles": 0,
        "acceptedFormats": [
          "string"
        ],
        "fileLabels": [
          "string"
        ],
        "maxFileSizeMb": 0
      }
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "string"
  }
}

List accessible workflows

Authorization

Query Parameters

Header Parameters

Response

TypeScript