Workbench 보드 객체 API (V2)

Board Object는 워크벤치 보드에 배치된 Foundry 객체입니다. 보드 안에서 객체가 어느 작업 상태에 있는지 관리하며, 상태는 보드의 열에 대응합니다.

추가와 이동

객체 추가는 Foundry 객체를 보드에 연결합니다. 상태를 지정하면 그 열에 배치하고, 생략하면 보드에서 설정한 순서의 첫 상태를 사용합니다. 기본 상태가 없는 보드에서 상태도 생략하면 오류가 발생합니다.

객체 이동은 이미 보드에 있는 객체를 다른 상태로 옮깁니다. 이동 대상 stateId는 필수이며 보드 항목의 식별자와 편집 이력을 유지합니다. objectRids에는 Foundry 객체의 RID를 전달합니다.

이미 있는 객체를 추가하는 요청과 보드에 없는 객체를 이동하는 요청은 각각 오류가 됩니다. 보드에서 요구하는 인터페이스 또는 객체 유형과 보안 조건을 만족하는 실제 객체를 선택합니다.

오류 처리

추가가 항목 수 제한을 넘으면 BoardExceededItemLimit의 currentItems와 maxItems를 확인합니다. 필요한 인터페이스 설정이 없는 BoardInterfaceTypeNotSet은 FAILED_PRECONDITION 코드와 HTTP 500을 반환합니다. 이 경우 보드 구성을 확인해야 하며 상태 코드만 보고 같은 추가 요청을 반복하지 않습니다.

성공 응답 형식은 EmptySuccessResponse이며, 새 보드 항목 ID나 변경 이력이 포함되지 않은 빈 객체입니다. 두 API는 preview=true와 api:workbench-write 권한 범위를 사용하며 실제 보드의 연결 또는 상태를 변경합니다.