メンバーを追加

既存の BazaarLink ユーザー(email で検索)を指定した組織に追加します。このエンドポイントは**新規アカウントを作成せず、招待メールも送信しません**——対象者はすでに BazaarLink アカウントを持っている必要があり、そうでない場合は 404 を返します。role を省略するとデフォルトで member になります。有効な値は org_admin、billing_viewer、team_admin、member の 4 種類です。呼び出せるのはその組織の org_admin のみです。

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

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

パスパラメータ

orgId必須

string

組織 ID。GET /orgs のレスポンスから取得します。

Body

email必須

string

追加するユーザーの email。大文字小文字を区別せずに照合し、前後の空白は削除されます。

role

string

メンバーの役割。省略時のデフォルトは member です。

org_adminbilling_viewerteam_adminmember

Example: "member"

teamId

string | null

指定したチーム(チーム一覧のレスポンスから取得)にメンバーを割り当てます。省略または null はチームの割り当てなしを意味します。

monthlyBudget

number | null

任意の月間予算額(米ドル)。範囲検証はありません。

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"
    }
  }
}