조직

멤버 추가

기존 BazaarLink 사용자(이메일로 조회)를 지정된 조직에 추가합니다. 이 엔드포인트는 **새 계정을 생성하거나 초대 이메일을 보내지 않습니다** — 대상자는 이미 BazaarLink 계정을 가지고 있어야 하며, 그렇지 않으면 요청이 404를 반환합니다. role을 생략하면 기본값은 member입니다. 유효한 값은 org_admin, billing_viewer, team_admin, member입니다. 해당 조직의 org_admin만 호출할 수 있습니다.

POST/api/v1/orgs/:orgId/members

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

경로 파라미터

orgId필수

string

조직 ID, GET /orgs 응답에서 가져옵니다.

Body

email필수

string

추가할 사용자의 이메일. 대소문자를 구분하지 않고 공백이 제거된 상태로 매칭됩니다.

role

string

멤버의 역할, 생략 시 기본값은 member입니다.

org_adminbilling_viewerteam_adminmember

Example: "member"

teamId

string | null

지정된 팀(팀 목록 응답에서)에 멤버를 배정합니다. 생략하거나 null이면 팀 배정이 없음을 의미합니다.

monthlyBudget

number | null

선택적 월간 예산 금액(USD). 범위 검증이 없습니다.

POST /api/v1/orgs/:orgId/members

1
2
3
4
curl -X POST https://bazaarlink.ai/api/v1/orgs/org_abc123/members \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com", "role": "member", "teamId": "team_abc123"}'

응답 예시

추가됨.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "member": {
    "id": "orgmem_abc123",
    "role": "member",
    "monthlyBudget": null,
    "joinedAt": "2026-07-27T00:00:00.000Z",
    "teamId": "team_abc123",
    "user": {
      "id": "usr_xyz789",
      "name": "Jane Doe",
      "email": "jane@acme.com"
    },
    "team": {
      "id": "team_abc123",
      "name": "Engineering"
    }
  }
}