Organization

Organization 생성#

POST /api/organizations

Organization·internal default workspace·생성자 active 소속을 한 트랜잭션에서 만들고 pending으로 생성하며 기존 세션의 현재 Organization 선택을 유지합니다. 세션 쿠키 structly_session이 필요합니다(Bearer 토큰 불가).

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: OrganizationCreate

응답

201 응답 본문

타입: Organization

Organization 소속 User 목록#

GET /api/organizations/{organization_id}/members

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

배열(Member[])이며 표는 항목의 필드입니다.

Organization 소속 User 단건#

GET /api/organizations/{organization_id}/members/{id}

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: Member

소속 상태 또는 관리자 권한 변경#

PATCH /api/organizations/{organization_id}/members/{id}

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: MemberChange

표시할 최상위 필드가 없습니다.

응답

200 응답 본문

타입: Member

Organization 초대 목록#

GET /api/organizations/{organization_id}/invitations

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

배열(Invitation[])이며 표는 항목의 필드입니다.

이메일 초대 발송#

POST /api/organizations/{organization_id}/invitations

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: InvitationCreate

응답

201 응답 본문

타입: Invitation

초대 단건#

GET /api/organizations/{organization_id}/invitations/{id}

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: Invitation

초대 취소#

DELETE /api/organizations/{organization_id}/invitations/{id}

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: Invitation

초대 재발송·이전 링크 무효화#

POST /api/organizations/{organization_id}/invitations/{id}/resend

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: Invitation

초대받은 이메일 User의 수락 전 확인#

POST /api/invitations/preview

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: InvitationToken

응답

200 응답 본문

타입: Invitation

초대 수락·소속 생성 또는 복구#

POST /api/invitations/accept

User 세션 전용입니다. Organization 관리자는 active 관리자 소속과 verified 상태를 요구합니다. 초대 토큰은 본문으로만 전달하며 저장·응답·로그에 평문을 남기지 않습니다.

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: InvitationToken

응답

200 응답 본문

타입: Member

Organization handle 사용 가능 여부 조회#

GET /api/organization-handles/{handle}

로그인한 User에게 handle 정규화 결과와 사용 가능 여부만 반환합니다. Organization의 이름·자산·ID는 반환하지 않습니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: OrganizationHandleAvailability

Organization handle 조회#

GET /api/organizations/{id}/handle

인증 완료 Organization의 active 관리자만 사용합니다. 내부 Organization ID로 지정합니다.

인증: 세션 쿠키

Parameter

응답

200 응답 본문

타입: OrganizationHandle

Organization handle 변경#

PATCH /api/organizations/{id}/handle

인증 완료 Organization의 active 관리자만 사용합니다. 내부 Organization ID로 지정합니다. 변경 시 이전 handle은 즉시 재사용할 수 있으며 별칭·자동 이동을 제공하지 않습니다.

인증: 세션 쿠키

Parameter

요청 본문

application/json · 필수: 예

타입: OrganizationHandleInput

응답

200 응답 본문

타입: OrganizationHandle