API 참조
WorkItem 작업, 의사결정 단계 제어, 연동 실행, 텔레메트리 내보내기에 대한 참조입니다.
이 API는 명시적 정책 및 테넌트 범위로 예측 가능한 자동화 동작을 위해 설계되었습니다.
기본 엔드포인트
인증된 요청에는 구성된 공개 API 엔드포인트를 사용하세요.
https://api.threada.ai인증 및 컨텍스트
- API 액세스에는 범위 지정 자격 증명을 사용하세요
- 필요한 경우 테넌트 및 역할 컨텍스트를 포함하세요
- 유효한 컨텍스트가 없는 요청은 fail closed됩니다
일반 범위
- workitems:read 및 workitems:write
- 정책 및 의사결정 업데이트용 workflow:manage
- 거버넌스 적용 실행용 actions:execute
- 내보내기 및 분석용 telemetry:read
페이지네이션 및 필터링
- 목록 엔드포인트는 cursor 또는 token 기반 페이지네이션을 지원합니다
- 채널, 워크플로, 상태, 정책 버전, 시간 범위별 필터링
- 대규모 텔레메트리 내보내기에는 제한된 창을 권장합니다
오류 모델
- 검증, 권한 부여, 정책, 실행 실패에 대한 타입 지정 오류 카테고리
- 사유 코드는 운영자 도구에서 결정적 처리를 지원합니다
- 서비스 간 조사를 위해 correlation IDs가 반환됩니다
예시 요청
접수 payload에서 WorkItem 생성
워크플로 처리를 위한 표준 업무 기록을 생성합니다. 필요한 경우 접수 채널의 채널 식별자를 포함하세요.
요청
curl -X POST "https://api.threada.ai/api/v1/public/work-items" \
-H "X-API-Key: <api-key>" \
-H "Content-Type: application/json" \
-d "{\"subject\":\"Review renewal request\",\"channel\":\"web\",\"channel_id\":\"web_main\",\"initial_message\":{\"role\":\"user\",\"content\":\"Review this renewal request before approval\"},\"tags\":[\"policy_review\"]}" 응답
{
"work_item": {
"summary": {
"work_item_id": "wi_123",
"status": "new",
"subject": "Review renewal request"
}
}
}승인된 작업 실행
구성된 연동에 대해 정책 승인된 작업을 실행합니다.
요청
curl -X POST "https://api.threada.ai/api/v1/public/work-items/wi_123/actions" \
-H "X-API-Key: <api-key>" \
-H "Content-Type: application/json" \
-d "{\"integration_id\":\"int_workflow\",\"idempotency_key\":\"act_456\",\"payload\":{\"type\":\"custom_http\",\"method\":\"POST\",\"url\":\"https://api.example.com/approvals\",\"body_json\":\"{\\\"approved\\\":true}\"}}" 응답
{
"action": {
"action_id": "act_456",
"work_item_id": "wi_123",
"action_type": "custom_http",
"status": "completed"
}
}