MINARA

Team 정기 작업 실행

POST /v1/team/routine-hooks/:triggerId: 외부 JSON 이벤트를 받아 지시를 Team 대기열에 추가합니다.

POST /v1/team/routine-hooks/:triggerId

외부 JSON 이벤트를 받아 설정된 지시를 사용자 메시지로 해당 Team 대기열에 추가합니다. Team Coordinator가 기존 처리 경로로 대기 중인 턴을 실행합니다. 서비스가 실행 중이며 로컬 네트워크에서 접근할 수 있어야 합니다. 클라우드 중계는 제공하지 않습니다.

메서드POST
경로/v1/team/routine-hooks/:triggerId
인증게이트웨이 공통 인증 없음
분류sessions

요청 본문

{ "event": "changed", "evidence": { "source": "https://example.com/item" } }

응답 본문

{ "automation_run_id": "run_123", "duplicate": false }

참고

트리거 전용 시크릿이 필요합니다. JSON 객체는 64 KiB를 넘을 수 없습니다. 활성 상태인 정기 작업은 최대 100개의 턴을 대기열에 수락합니다.

동일한 멱등성 키와 동등한 JSON을 보내면 원래 실행 ID와 duplicate=true, HTTP 202를 반환합니다. 동일한 키로 다른 JSON을 보내면 409를 반환합니다. 키를 생략하면 각 호출을 독립적으로 처리합니다.

HTTP 202는 메시지와 턴이 영구 저장되었음을 의미합니다. Team의 작업 완료를 보장하지는 않습니다. 원본 JSON은 서버 측 턴 컨텍스트에 보관하며 모든 Agent가 접근할 수 있습니다. 공개 메시지나 기록 응답에는 포함하지 않습니다.

일시 중지하면 새 트리거를 거부합니다. 이미 수락한 턴은 계속 실행합니다. 시크릿을 교체하면 기존 시크릿은 즉시 무효화됩니다.

목차