워크플로

목록 조회

GET /workflows — 워크스페이스의 모든 워크플로를 활성 상태와 함께 조회합니다.

• Scope: workflows:read

자동화 연동에서 워크플로의 id와 활성 여부를 조회하는 용도입니다. 워크플로 정의(노드·조건 등)는 공개 API로 노출되지 않습니다. 워크플로 수는 관리자가 정의하는 소규모 집합이라 페이지네이션이 없으며(meta 없음), 전체 목록을 한 번에 반환합니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/workflows" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "영업시간 외 자동 응답",
      "is_active": true,
      "created_at": "2026-03-01T09:00:00Z"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "name": "리마인더 (비활성)",
      "is_active": false,
      "created_at": "2026-03-02T10:30:00Z"
    }
  ]
}

워크플로가 없으면 data는 빈 배열([])입니다. is_active는 발행/활성 여부 플래그로, 비활성 워크플로도 함께 반환됩니다(필터 없음).

워크플로 목록은 별도 워크플로 엔진에서 조회하므로, 엔진 일시 장애 시 500 INTERNAL이 반환될 수 있습니다 — 에러 가이드에 따라 백오프 후 재시도하세요. 이 500의 응답 본문에는 별도 details가 없으므로(상류 엔진 오류 노출 방지를 위해 메시지가 비어 있음), 백오프 후 재시도가 유일한 대응입니다.