워크플로우 API

📌 워크플로우 생성/수정/실행/조회 엔드포인트는 콘솔 사용자 JWT 가 필요합니다. SDK / Public Key 로는 HTTP 웹훅 트리거만 호출할 수 있습니다.

워크플로우 생성 (콘솔 JWT)

POST /v1/apps/:appID/workflows

bash

curl -X POST "https://api.connectbase.world/v1/apps/app_xxx/workflows" \
  -H "Authorization: Bearer user_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "사용자 온보딩",
    "execution_type": "sequential",
    "steps": [
      {
        "step_type": "function",
        "function_id": "fn_send_welcome_email",
        "order": 0,
        "on_error": "stop"
      }
    ]
  }'

필드	타입	필수	설명
`name`	string	✓	워크플로우 이름 (1~100자)
`description`	string	✗	설명 (최대 500자)
`execution_type`	string	✗	`sequential` / `parallel` / `conditional`
`steps`	array	✗	스텝 정의 배열 (최대 100개)
`schedule_cron`	string	✗	cron 표현식 (존재하면 활성)
`schedule_timezone`	string	✗	타임존 (예: `Asia/Seoul`)
`timeout_seconds`	number	✗	0~1800
`max_retries`	number	✗	0~10
`initial_input`	object	✗	초기 입력

스텝(steps[]) 항목 필드:

필드	타입	설명
`step_type`	string	`function` / `condition` / `parallel` / `merge` / `agent`
`function_id`	string	function 스텝일 때 호출할 함수 ID
`order`	number	실행 순서
`on_error`	string	`stop` / `continue` / `retry`
`retry_count`	number	0~5
`retry_delay`	number	재시도 지연 (ms, 0~60000)
`input_mapping`	object	이전 스텝 결과를 다음 스텝 입력으로 매핑

⚠️ trigger 필드는 존재하지 않습니다 — 스케줄 실행은 schedule_* 필드로, HTTP 트리거는 별도 webhook 엔드포인트로 처리됩니다.

워크플로우 목록 조회

GET /v1/apps/:appID/workflows

워크플로우 상세 조회

GET /v1/apps/:appID/workflows/:workflowID

워크플로우 수정

PUT /v1/apps/:appID/workflows/:workflowID

워크플로우 삭제

DELETE /v1/apps/:appID/workflows/:workflowID

워크플로우 수동 실행

POST /v1/apps/:appID/workflows/:workflowID/execute

bash

curl -X POST "https://api.connectbase.world/v1/apps/app_xxx/workflows/wf_xxx/execute" \
  -H "Authorization: Bearer user_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "input": { "userId": "user-123" }
  }'

실행 이력 조회

GET /v1/apps/:appID/workflows/:workflowID/executions

실행 상세 조회

GET /v1/apps/:appID/workflows/:workflowID/executions/:executionID

실행 취소

POST /v1/apps/:appID/workflows/:workflowID/executions/:executionID/cancel

실행 SSE 스트리밍

GET /v1/apps/:appID/workflows/:workflowID/executions/stream GET /v1/apps/:appID/workflows/:workflowID/executions/:executionID/stream

Server-Sent Events 로 실행 진행 상황을 실시간 수신합니다.

웹훅 API

앱 템플릿 API