updateOrgMember
PATCH
/api/v1/orgs/{org_id}/members/{user_id}
const url = 'https://dev.api.endueos.com/api/v1/orgs/org_01J9ZK3Q8M4XW7D2N5R6T0V1BC/members/example';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"role":"owner"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://dev.api.endueos.com/api/v1/orgs/org_01J9ZK3Q8M4XW7D2N5R6T0V1BC/members/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "role": "owner" }'역할을 바꾼다 (owner·admin). owner 로 올리거나 owner 를 내리는 것은 owner 만. 마지막 owner 는 내릴 수 없다 (409 LAST_OWNER).
파라미터
섹션 제목: “파라미터”경로 파라미터
섹션 제목: “경로 파라미터”org_id
필수
조직 — 크레딧·결제·멤버의 주인 (D-46 · D-60).
string
예시
org_01J9ZK3Q8M4XW7D2N5R6T0V1BCuser_id
필수
usr_{Keycloak sub} — ULID 가 아니다.
string
요청 본문필수
섹션 제목: “요청 본문필수”Media typeapplication/json
object
role
필수
Owner > admin > member. 조직마다 owner 가 적어도 한 명이다.
string
200
섹션 제목: “200”성공.
Media typeapplication/json
object
data
필수
조직의 멤버.
object
user_id
필수
usr_{Keycloak sub} — ULID 가 아니다.
string
org_id
필수
조직 — 크레딧·결제·멤버의 주인 (D-46 · D-60).
string
role
필수
Owner > admin > member. 조직마다 owner 가 적어도 한 명이다.
string
created_at
필수
string format: date-time
meta
필수
object
request_id
필수
string
timestamp
필수
string format: date-time
duration
서버 처리 시간(ms).
integer format: int32
예시
{ "data": { "org_id": "org_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "role": "owner" }}400
섹션 제목: “400”요청 형식이 틀렸다 — VALIDATION_ERROR(details.errors[]) 또는 BAD_REQUEST. 본문은 오류 봉투.
401
섹션 제목: “401”인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.
403
섹션 제목: “403”이 인증 수단으로는 못 하는 일이다 — FORBIDDEN (예: API 키로 클라우드 기기 만들기). 본문은 오류 봉투.
404
섹션 제목: “404”없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.
409
섹션 제목: “409”지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.
429
섹션 제목: “429”한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.
500
섹션 제목: “500”서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.
503
섹션 제목: “503”의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.