addOrgMember
POST
/api/v1/orgs/{org_id}/members
const url = 'https://dev.api.endueos.com/api/v1/orgs/org_01J9ZK3Q8M4XW7D2N5R6T0V1BC/members';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"email":"hello@example.com","role":"owner"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://dev.api.endueos.com/api/v1/orgs/org_01J9ZK3Q8M4XW7D2N5R6T0V1BC/members \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "email": "hello@example.com", "role": "owner" }'이메일로 멤버를 넣는다 (owner·admin, owner 지정은 owner 만). 가입한 사람이 없으면 404 USER_NOT_FOUND,
이미 멤버면 409 MEMBER_EXISTS.
파라미터
섹션 제목: “파라미터”경로 파라미터
섹션 제목: “경로 파라미터”org_id
필수
조직 — 크레딧·결제·멤버의 주인 (D-46 · D-60).
string
예시
org_01J9ZK3Q8M4XW7D2N5R6T0V1BC요청 본문필수
섹션 제목: “요청 본문필수”Media typeapplication/json
이미 가입한 사람만 넣는다 — endue OS 에 한 번 로그인했고 이메일이 확인된 사람. 없으면 404 USER_NOT_FOUND.
object
email
필수
string format: email
role
기본 member. owner 는 owner 만 정한다.
string
201
섹션 제목: “201”만들었다.
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”의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.