워크스페이스 멤버 추가

조직 멤버를 워크스페이스에 배정합니다

PUT /v1/organizations/{org_id}/workspaces/{workspace_id}/members/{user_id}

인증

방식	허용	조건
API 키 (`Authorization: Bearer xci_live_…`)	불가	콘솔 세션 전용, 키로 부르면 403 console_only
콘솔 세션 쿠키	가능	조직 역할 `owner`, `admin`, 같은 출처의 Origin 헤더 필요

참고 서버 구현(2026-10-12 dev 기준)이 계약 초안과 다른 점
서버 응답은 {userid, email, name}입니다, 계약의 workspaceid, role, added_at은 없습니다
조직 멤버가 아닌 사용자는 404 member not found입니다

매개변수

이름	위치	타입	필수	설명
`org_id`	경로	string	필수	조직 ID, 형식 `^org_[A-Za-z0-9]+$`
`workspace_id`	경로	string	필수	워크스페이스 ID, 형식 `^wrk_[A-Za-z0-9]+$`
`user_id`	경로	string	필수	사용자 ID, 형식 `^usr_[A-Za-z0-9]+$`

응답

200

필드	타입	항상	설명
`workspace_id`	string	항상	워크스페이스 ID
`user_id`	string	항상	사용자 ID
`email`	string		이메일
`role`	`owner` \| `admin` \| `developer`		역할(owner, admin, developer)
`added_at`	timestamp	항상	배정 시각

{
  "workspace_id": "wrk_3fK9Qm2Zp8",
  "user_id": "usr_5Jd2Lm8Qw1",
  "email": "dev@example.com",
  "role": "developer",
  "added_at": "2026-10-12T03:11:05Z"
}

오류

HTTP	코드	다시 시도	뜻
400	`invalid_request`	아니오	본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401	`session_required`	아니오	콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403	`console_only`	아니오	콘솔 세션 전용 엔드포인트입니다, API 키로는 결제, 키, 멤버 관리를 할 수 없습니다
403	`insufficient_permission`	아니오	역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
403	`workspace_archived`	아니오	보관된 워크스페이스입니다, 키는 폐기되었고 새 잡은 거절됩니다
404	`not_found`	아니오	자원이 없거나 이 호출자에게 보이지 않습니다
429	`rate_limited`	가능	이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500	`internal_error`	가능	예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl -X PUT "https://xenoci.com/api/runner/v1/organizations/org_7Kq2m9ZtP3/workspaces/wrk_3fK9Qm2Zp8/members/usr_5Jd2Lm8Qw1" \
  --cookie "xci_console=$SESSION" \
  -H "Origin: https://xenoci.com"

다음 단계

워크스페이스 목록 GET /v1/organizations/{org_id}/workspaces
워크스페이스 만들기 POST /v1/organizations/{org_id}/workspaces
워크스페이스 조회 GET /v1/organizations/{orgid}/workspaces/{workspaceid}
워크스페이스 수정 PATCH /v1/organizations/{orgid}/workspaces/{workspaceid}