주요 콘텐츠로 건너뛰기
개발자를 위한 기능

AI 워크플로를 하나의 API처럼 사용합니다

트리거, 결과 조회, 승인 처리, 산출물 수령까지 모두 REST입니다. 모델 호출, 재시도, 대기열을 직접 관리할 필요가 없습니다.

무료로 시작하기API 문서 보기 →
14개 v1 엔드포인트6가지 권한 범위7가지 언어 샌드박스
braidrun v1 APIREST · JSON
# 실행을 한 번 트리거
POST /api/webhooks/{id}/trigger
→ {"executionId": "exec_51a2"}

# 상태 폴링: 이번에는 사람 승인에서 멈췄습니다
GET  /api/v1/executions/exec_51a2
→ {"status": "AWAITING_APPROVAL"}

# 승인 후 계속 실행(수치는 먼저 수정한 뒤 승인할 수 있습니다)
POST /api/v1/approvals/{approvalId}/approve

# 완료 후 결과와 산출물 수령
GET  /api/v1/executions/exec_51a2/result
GET  /api/v1/executions/exec_51a2/artifacts
연동 경로

15분 만에 Webhook 생성부터 첫 결과 수령까지

네 개의 HTTP 요청으로 전체 프로세스를 실행하며 SDK가 필요 없습니다. 요청을 보낼 수 있는 언어라면 무엇이든 연동할 수 있습니다.

01Webhook을 생성하고 URL과 Key를 받습니다콘솔에서 워크플로에 Webhook 트리거를 추가하여 전용 URL을 받고, WEBHOOK_TRIGGER 범위의 API Key를 하나 생성합니다.
WEBHOOK_TRIGGERX-API-Key
02한 번의 POST로 실행을 트리거합니다JSON 최상위 필드가 같은 이름의 워크플로 변수로 자동 매핑되며, variableMapping으로 명시적으로 매핑할 수도 있습니다. payload 상한은 1MB입니다.
POST≤ 1MB
03실행 상태를 폴링하여 결과를 받습니다반환된 executionId로 실행 상세를 조회하고, 실행이 끝나면 result 엔드포인트에서 출력을 받고 artifacts 엔드포인트에서 파일을 다운로드합니다.
GET /api/v1/executions/{id}EXECUTION_READ
04사람 검토가 필요한 동작은 승인 API를 사용합니다실행은 manual_approval 단계에서 멈춥니다. 승인 엔드포인트로 승인 대기 항목을 나열하고 승인하거나 거부하며, 거부되거나 타임아웃되면 아무것도 변경되지 않습니다.
APPROVAL_RESPOND타임아웃 시 자동 거부
terminalX-API-Key · JSON ≤ 1MB
# 2단계: 시스템에서 POST를 한 번 발송
curl -X POST https://your-host/api/webhooks/{id}/trigger \
  -H "X-API-Key: <your-api-key>" \
  -d '{"ticket_id": "T-1024", "lang": "zh"}'
# 최상위 필드가 같은 이름의 워크플로 변수로 자동 매핑됩니다
→ {"executionId": "exec_51a2"}

# 3단계: 상태를 폴링하고 실행이 끝나면 결과 수령
curl https://your-host/api/v1/executions/exec_51a2/result \
  -H "X-API-Key: <your-api-key>"
기능 목록

코드를 작성하는 사람이 신경 쓰는 여섯 가지

7가지 언어의 샌드박스 코드 단계Python, JavaScript, TypeScript, Bash, Ruby, Lua, CLI 모두 작성할 수 있습니다. 변수는 WF_VAR_* 환경 변수로 주입되고 기본 타임아웃은 30초이며, 프로덕션 환경에서는 아웃바운드 통신이 통제된 Docker 샌드박스에서 실행됩니다.
WF_VAR_*30s timeout
YAML 정의로 Git 프로세스를 따릅니다하나의 워크플로는 하나의 YAML 파일입니다. 커밋, diff, 되돌리기 모두 익숙한 저장소에서 처리합니다. 캔버스와 YAML은 양방향으로 동기화되므로 어느 쪽을 수정해도 됩니다.
workflow.yamlgit diff
MCP로 자신의 도구를 연동합니다내부 서비스를 MCP Server로 감싸 Agent에 연결하면 AI 단계가 자신의 시스템을 바로 호출할 수 있으며, 플랫폼이 커넥터를 내놓기를 기다릴 필요가 없습니다.
MCPagent tools
중단점 디버거9가지 중단점은 적중하면 일시 중지되며, 변수를 수정한 뒤 계속합니다. 실패 후에는 지정한 단계부터 다시 실행하고, 이미 완료된 LLM 단계는 중복 과금되지 않습니다.
9 breakpoints프로
14개 엔드포인트 v1 API, 최소 권한실행 트리거, 결과 조회, 승인 처리, 산출물 다운로드에 각각 독립적인 권한 범위가 있습니다. 6가지 범위를 필요에 따라 조합하여 연동하는 시스템마다 각자의 Key를 발급합니다.
v16 scopes
체인 트리거 DELAYED_COMPLETIONA가 완료된 뒤 N초 후 B를 자동으로 트리거하며 maxRuns 상한을 설정할 수 있습니다. 긴 프로세스를 몇 개의 구간으로 나누어 구간별로 로그와 비용을 따로 확인합니다.
DELAYED_COMPLETIONmaxRuns
솔직한 경계

세 가지를 먼저 말씀드립니다

연동 중간에 가서야 알게 되는 일을 방지하기 위함입니다.

수백 개의 SaaS 커넥터는 없습니다외부 시스템 호출은 코드 단계에 작성하거나 MCP 도구로 감싸 Agent에 연결합니다. 코드를 작성하는 팀에게 이 과정은 HTTP 요청 몇 줄에 불과합니다.
실행 전 비용 예측 API는 없습니다실행마다 token 사용량과 비용이 호출 단위로 기록되어 사후 정산은 세밀합니다. 다만 실행 전에는 견적을 받을 수 없으므로 예산 관리는 승인 게이트와 maxRuns에 의존해야 합니다.
제한을 먼저 명확히 공개합니다Webhook payload 상한은 1MB이고, 코드 단계의 기본 타임아웃은 30초입니다. HMAC-SHA256 서명은 호환 모드로만 유지되며 새 연동에는 API Key를 사용합니다.
문서 진입점

연동 전에 읽어 둘 만한 세 편입니다

GET /api/v1/*v1 API 참조14개 엔드포인트의 요청 및 응답 필드, 오류 코드, 그리고 6가지 권한 범위 설정 방법입니다.문서 열기 →POST /api/webhooks/*Webhook 트리거URL과 Key 수령, 변수 매핑 규칙, HMAC 호환 모드 및 1MB 제한입니다.문서 열기 →workflow.yamlYAML 구문8가지 단계 유형과 condition, retry, manual_approval 등 수정자의 작성 방법입니다.문서 열기 →
첫 번째 워크플로를 시스템에 연결합니다
Free 요금제로도 워크플로를 구성하고 수동으로 실행할 수 있습니다. Webhook 트리거와 정기 스케줄링이 필요하면 그때 Pro로 업그레이드하세요.
무료로 시작하기API 문서 보기