メンバー API

このドキュメントについて

Qoder UI 外でメンバーとクォータを管理するインテグレーション向け。事前に API キーの取得 を完了し、共通仕様 を参照してください。

前提条件

有効な API キー：Authorization: Bearer <api_key>。
キーは対象組織に紐づき、呼び出し元の権限が操作を許可している必要があります。

API 一覧

1. メンバー一覧

GET /v1/organizations/{organization_id}/members 組織のメンバーリストをページネーションで取得します。キーワード検索をサポートします。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

パラメータ	型	必須	説明
`email`	string	いいえ	メール完全一致検索
`includeDeleted`	string	いいえ	`true` に設定すると削除済みメンバーを含む
`maxResults`	integer	いいえ	ページサイズ（デフォルト 20、最大 100）
`nextToken`	string	いいえ	ページネーションカーソル

成功レスポンス（200 OK）

デフォルトクエリ（アクティブメンバーのみ）：

{
  "members": [
    {
      "id": "member_abc123",
      "name": "Alice",
      "email": "alice@example.com",
      "role": "org_admin",
      "status": "ENABLED",
      "joinedAt": "2025-06-01T08:00:00Z"
    },
    {
      "id": "member_ghi789",
      "name": "Charlie",
      "role": "org_member",
      "status": "ENABLED",
      "joinedAt": "2025-07-10T14:30:00Z"
    }
  ],
  "maxResults": 20,
  "nextToken": "eyJwYWdlIjogMn0="
}

一部のメンバーレコードでは email フィールドが返されない場合があります。インテグレーション時はオプションフィールドとして処理してください。

削除済みメンバーを含む（**includeDeleted=true**）：

{
  "members": [
    {
      "id": "member_abc123",
      "name": "Alice",
      "email": "alice@example.com",
      "role": "org_admin",
      "status": "ENABLED",
      "joinedAt": "2025-06-01T08:00:00Z"
    },
    {
      "id": "member_def456",
      "name": "Bob",
      "email": "bob@example.com",
      "role": "org_member",
      "status": "DELETED",
      "joinedAt": "2025-03-15T10:00:00Z",
      "deletedAt": "2026-02-01T12:00:00Z"
    }
  ],
  "maxResults": 20,
  "nextToken": ""
}

deletedAt は削除済みメンバーにのみ返されます。アクティブメンバーにはこのフィールドは含まれません。nextToken が空文字列の場合は最終ページです。

レスポンスフィールド

フィールド	型	説明
`members`	array	メンバーリスト
`members[].id`	string	メンバー ID
`members[].name`	string	メンバー名
`members[].email`	string	メンバーメール（空の場合あり）
`members[].role`	string	ロール名（例：`org_admin`、`org_member`）
`members[].status`	string	メンバーステータス：`ENABLED`（アクティブ）、`DISABLED`（停止済み）、`UNACTIVATED`（未アクティブ化）、`APPROVE_PENDING`（承認待ち）、`APPROVE_DECLINED`（承認拒否）、`DELETED`（削除済み）
`members[].joinedAt`	string	参加日時（ISO 8601）
`members[].deletedAt`	string または null	削除日時（ISO 8601）；アクティブメンバーには返されない
`maxResults`	int32	このリクエストのページサイズ
`nextToken`	string	次ページカーソル；空は最終ページ

2. メンバー詳細取得

GET /v1/organizations/{organization_id}/members/{member_id} 単一メンバーの詳細情報を取得します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID

成功レスポンス（200 OK）

アクティブメンバー：

{
  "id": "member_abc123",
  "name": "Alice",
  "email": "alice@example.com",
  "role": "org_admin",
  "status": "ENABLED",
  "joinedAt": "2025-06-01T08:00:00Z"
}

削除済みメンバー（**GetMember** は削除済みメンバーも自動的に含む）：

{
  "id": "member_def456",
  "name": "Bob",
  "email": "bob@example.com",
  "role": "org_member",
  "status": "DELETED",
  "joinedAt": "2025-03-15T10:00:00Z",
  "deletedAt": "2026-02-01T12:00:00Z"
}

レスポンスフィールド

「メンバー一覧」の members[] フィールドと同一です。

3. メンバー統計取得

GET /v1/organizations/{organization_id}/members/statistics 組織メンバーに関する統計データを取得します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

成功レスポンス（200 OK）

{
  "totalMembers": 50,
  "billableMembers": 45,
  "adminMembers": 3,
  "purchasedSeats": 100,
  "remainingSeats": 55
}

レスポンスフィールド

フィールド	型	説明
`totalMembers`	int32	総メンバー数
`billableMembers`	int32	課金対象メンバー数
`adminMembers`	int32	管理者数
`purchasedSeats`	int32	購入済みシート数
`remainingSeats`	int32	残りシート数

4. メンバー削除

DELETE /v1/organizations/{organization_id}/members/{member_id} 組織からメンバーを削除します。削除前に、現在の課金サイクル内での使用量を確認します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID

成功レスポンス（200 OK）

現サイクルで使用量あり（シート解放はサイクル終了まで遅延）：

{
  "id": "member_abc123",
  "hasBillingCycleUsage": true
}

現サイクルで使用量なし（シートを即時解放可能）：

{
  "id": "member_abc123",
  "hasBillingCycleUsage": false
}

レスポンスフィールド

フィールド	型	説明
`id`	string	削除されたメンバーの ID
`hasBillingCycleUsage`	bool	現在の課金サイクル内で使用量があるか（シート解放タイミングに影響）

エラーレスポンス

メンバーがチームに所属していない（404）

{
  "requestId": "req_abc123",
  "code": "UserNotTeamMember",
  "message": "User is not a member of this team"
}

メンバー数不足（400）

{
  "requestId": "req_abc123",
  "code": "InsufficientMembers",
  "message": "The number of organization members cannot be less than the minimum requirement"
}

5. メンバークォータ取得

GET /v1/organizations/{organization_id}/members/{member_id}/quota 指定メンバーの完全な使用状況を取得します。プランクォータ、リソースパッククォータ、合計クォータ、組織共有パッククォータを含みます。現在は big_model_credits ディメンション固定です。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID

成功レスポンス（200 OK）

組織共有パックあり、ステータス正常：

{
  "userId": "user_abc123",
  "quotaKey": "big_model_credits",
  "planQuota": {
    "quotaSummary": {
      "usedValue": 350.5,
      "limitValue": 1000.0,
      "unit": "credits"
    }
  },
  "resourcePackageQuota": {
    "quotaSummary": {
      "usedValue": 100.0,
      "limitValue": 500.0,
      "unit": "credits"
    }
  },
  "totalQuota": {
    "quotaSummary": {
      "usedValue": 450.5,
      "limitValue": 1500.0,
      "unit": "credits"
    }
  },
  "sharedQuota": {
    "quotaSummary": {
      "usedValue": 200.0,
      "limitValue": 1000.0,
      "unit": "credits"
    }
  },
  "lastResetAt": "2026-03-01T00:00:00Z",
  "nextResetAt": "2026-04-01T00:00:00Z",
  "status": "active"
}

組織共有パックなし、使用量超過：

{
  "userId": "user_def456",
  "quotaKey": "big_model_credits",
  "planQuota": {
    "quotaSummary": {
      "usedValue": 1000.0,
      "limitValue": 1000.0,
      "unit": "credits"
    }
  },
  "totalQuota": {
    "quotaSummary": {
      "usedValue": 1000.0,
      "limitValue": 1000.0,
      "unit": "credits"
    }
  },
  "lastResetAt": "2026-03-01T00:00:00Z",
  "nextResetAt": "2026-04-01T00:00:00Z",
  "status": "restricted"
}

組織に共有パックがない場合 sharedQuota は返されません。メンバーにリソースパックがない場合 resourcePackageQuota は返されません。status が restricted の場合、使用量上限に達しています。

レスポンスフィールド

フィールド	型	説明
`userId`	string	ユーザー ID
`quotaKey`	string	クォータディメンションキー
`planQuota`	object	プランクォータ情報
`resourcePackageQuota`	object	リソースパッククォータ情報
`totalQuota`	object	合計クォータ情報（プラン + リソースパック）
`sharedQuota`	object または null	組織共有パッククォータ（組織に共有パックがない場合は返されない）
`lastResetAt`	string	前回リセット日時（ISO 8601）
`nextResetAt`	string	次回リセット日時（ISO 8601）
`status`	string	ユーザーステータス：`active` または `restricted`

クォータサマリーフィールド

フィールド	型	説明
`usedValue`	float64	使用量
`limitValue`	float64	クォータ上限
`unit`	string	単位（例：`credits`）

6. メンバー Add-On Cap 更新

PUT /v1/organizations/{organization_id}/members/{member_id}/addon-cap メンバーの Shared Add-On クォータキャップを更新します（Big Model Credits クォータに基づく）。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID

リクエストパラメータ（JSON）

フィールド	型	必須	バリデーション	説明
`addOnCap`	int64 または null	はい	非負の整数または null	クォータキャップ；`null` は無制限、`0` は無効

リクエスト例

クォータキャップを設定：

{
  "addOnCap": 1000
}

無制限に設定：

{
  "addOnCap": null
}

成功レスポンス（200 OK）

{
  "memberId": "member_abc123",
  "email": "alice@example.com",
  "addOnCap": 1000
}

無制限の場合：

{
  "memberId": "member_abc123",
  "email": "alice@example.com",
  "addOnCap": null
}

レスポンスフィールド

フィールド	型	説明
`memberId`	string	メンバー ID
`email`	string	メンバーメール
`addOnCap`	int64 または null	現在のクォータキャップ；`null` は無制限

エラーレスポンス

addOnCap 形式無効（400）

{
  "requestId": "req_abc123",
  "code": "InvalidAddOnCapFormat",
  "message": "Invalid addOnCap format"
}

メンバーがチームに所属していない（404）

{
  "requestId": "req_abc123",
  "code": "UserNotTeamMember",
  "message": "User is not a member of this team"
}

7. メンバー Add-On Cap 一括更新

POST /v1/organizations/{organization_id}/batchUpdateAddOnCap 指定メンバーの Shared Add-On クォータキャップを一括更新します（Big Model Credits クォータに基づく）。1リクエストあたり最大100メンバー、全メンバーに同じキャップを設定します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

リクエストパラメータ（JSON）

フィールド	型	必須	バリデーション	説明
`addOnCap`	int64 または null	はい	非負の整数または null	クォータキャップ；`null` は無制限、`0` は無効
`memberIds`	string[]	はい	1〜100 個の非空文字列	更新対象のメンバー ID リスト

リクエスト例

一括でクォータキャップを設定：

{
  "addOnCap": 1000,
  "memberIds": ["member_abc123", "member_def456"]
}

一括で無制限に設定：

{
  "addOnCap": null,
  "memberIds": ["member_abc123"]
}

成功レスポンス（200 OK）

{
  "members": [
    {
      "memberId": "member_abc123",
      "previousAddOnCap": 500
    },
    {
      "memberId": "member_def456",
      "previousAddOnCap": null
    }
  ]
}

previousAddOnCap が null の場合、そのメンバーは以前制限なし（無制限）でした。

レスポンスフィールド

フィールド	型	説明
`members`	array	更新結果リスト、リクエストの `memberIds` と同じ順序
`members[].memberId`	string	メンバー ID
`members[].previousAddOnCap`	int64 または null	更新前のクォータキャップ；`null` は以前無制限だったことを示す

エラーレスポンス

addOnCap 形式無効（400）

{
  "requestId": "req_abc123",
  "code": "InvalidAddOnCapFormat",
  "message": "Invalid addOnCap format"
}

memberIds が空（400）

{
  "requestId": "req_abc123",
  "code": "BadRequest",
  "message": "memberIds must not be empty"
}

memberIds が 100 件超過（400）

{
  "requestId": "req_abc123",
  "code": "BadRequest",
  "message": "memberIds must not exceed 100"
}

8. メンバー使用制限取得

GET /v1/organizations/{organization_id}/members/{member_id}/usage-limits/{quota_key} 指定メンバーの指定クォータキーにおける使用制限設定を取得します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID
`quota_key`	string	はい	クォータディメンションキー（例：`big_model_credits`）

成功レスポンス（200 OK）

制限有効：

{
  "id": "limit_abc123",
  "organizationId": "org_xxx",
  "userId": "user_abc123",
  "quotaKey": "big_model_credits",
  "limitValue": 1000.0,
  "usedValue": 350.5,
  "resetCycle": "monthly",
  "isActive": true,
  "lastResetAt": "2026-03-01T00:00:00Z",
  "nextResetAt": "2026-04-01T00:00:00Z"
}

制限一時停止（**isActive: false**）：

{
  "id": "limit_abc123",
  "organizationId": "org_xxx",
  "userId": "user_abc123",
  "quotaKey": "big_model_credits",
  "limitValue": 1000.0,
  "usedValue": 350.5,
  "resetCycle": "monthly",
  "isActive": false,
  "lastResetAt": "2026-03-01T00:00:00Z",
  "nextResetAt": "2026-04-01T00:00:00Z"
}

isActive が false の場合、制限ルールは適用されませんが、レコードは保持され、いつでも再有効化できます。

レスポンスフィールド

フィールド	型	説明
`id`	string	使用制限レコード ID
`organizationId`	string	組織 ID
`userId`	string	ユーザー ID
`quotaKey`	string	クォータディメンションキー
`limitValue`	float64	使用量上限値
`usedValue`	float64	使用量
`resetCycle`	string	リセットサイクル（例：`monthly`）
`isActive`	bool	有効かどうか
`lastResetAt`	string	前回リセット日時（ISO 8601）
`nextResetAt`	string	次回リセット日時（ISO 8601）

9. メンバー使用制限更新

PUT /v1/organizations/{organization_id}/members/{member_id}/usage-limits/{quota_key} 指定メンバーの指定クォータキーにおける使用制限を更新します。制限が存在しない場合は自動作成されます。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID
`quota_key`	string	はい	クォータディメンションキー（例：`big_model_credits`）

リクエストパラメータ（JSON）

フィールド	型	必須	説明
`limitValue`	float64	はい	使用量上限値
`resetCycle`	string	いいえ	リセットサイクル（例：`monthly`）
`isActive`	bool	いいえ	有効かどうか

リクエスト例

制限の作成または完全更新：

{
  "limitValue": 1000.0,
  "resetCycle": "monthly",
  "isActive": true
}

上限値のみ変更（既存の resetCycle と isActive を保持）：

{
  "limitValue": 2000.0
}

制限の一時停止（上限値は変更なし）：

{
  "limitValue": 1000.0,
  "isActive": false
}

成功レスポンス（200 OK）

「メンバー使用制限取得」と同じレスポンス形式です。

10. メンバー使用制限の解除

DELETE /v1/organizations/{organization_id}/members/{member_id}/usage-limits/{quota_key} 指定メンバーの指定クォータキーにおける使用制限を解除し、無制限状態に戻します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID
`member_id`	string	はい	メンバー ID
`quota_key`	string	はい	クォータディメンションキー（例：`big_model_credits`）

成功レスポンス（200 OK）

「メンバー使用制限取得」と同じレスポンス形式です。

エラーコード

エラーコード	HTTP ステータス	説明
`BadRequest`	400	リクエストパラメータが無効（例：member_id が空、addOnCap が負の数）
`InvalidAddOnCapFormat`	400	addOnCap 形式が無効
`InsufficientMembers`	400	組織メンバー数が最低要件を下回ることはできない
`Unauthorized`	401	API キーが欠落または無効
`Forbidden`	403	この組織へのアクセス権限なし
`NotFound`	404	メンバーが見つからない
`UserNotTeamMember`	404	ユーザーはこのチームのメンバーではない
`InternalError`	500	サーバー内部エラー

エラーレスポンスの形式は共通仕様の エラーレスポンス を参照してください。

使用例

メンバー一覧

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members?maxResults=20" \
  -H "Authorization: Bearer <api_key>"

メールでメンバー検索

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members?email=alice@example.com" \
  -H "Authorization: Bearer <api_key>"

メンバー一覧（削除済みを含む）

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members?includeDeleted=true" \
  -H "Authorization: Bearer <api_key>"

メンバー詳細取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123" \
  -H "Authorization: Bearer <api_key>"

メンバー統計取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members/statistics" \
  -H "Authorization: Bearer <api_key>"

メンバー削除

curl -X DELETE "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123" \
  -H "Authorization: Bearer <api_key>"

メンバー Add-On Cap 更新

curl -X PUT "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123/addon-cap" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "addOnCap": 1000
  }'

メンバークォータ取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123/quota" \
  -H "Authorization: Bearer <api_key>"

メンバー Add-On Cap 一括更新

curl -X POST "https://api.qoder.com/v1/organizations/org_xxx/batchUpdateAddOnCap" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "addOnCap": 1000,
    "memberIds": ["member_abc123", "member_def456"]
  }'

メンバー使用制限取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123/usage-limits/big_model_credits" \
  -H "Authorization: Bearer <api_key>"

メンバー使用制限更新

curl -X PUT "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123/usage-limits/big_model_credits" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "limitValue": 1000.0,
    "resetCycle": "monthly",
    "isActive": true
  }'

メンバー使用制限の解除

curl -X DELETE "https://api.qoder.com/v1/organizations/org_xxx/members/member_abc123/usage-limits/big_model_credits" \
  -H "Authorization: Bearer <api_key>"

はじめに

ユーザーガイド

コンテキスト

拡張機能

設定

アカウント

サポート

イベント

Documentation Index

​このドキュメントについて

​前提条件

​API 一覧

​1. メンバー一覧

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​2. メンバー詳細取得

​パスパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​3. メンバー統計取得

​パスパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​4. メンバー削除

​パスパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​エラーレスポンス

​5. メンバークォータ取得

​パスパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​6. メンバー Add-On Cap 更新

​パスパラメータ

​リクエストパラメータ（JSON）

​リクエスト例

​成功レスポンス（200 OK）

​レスポンスフィールド

​エラーレスポンス

​7. メンバー Add-On Cap 一括更新

​パスパラメータ

​リクエストパラメータ（JSON）

​リクエスト例

​成功レスポンス（200 OK）

​レスポンスフィールド

​エラーレスポンス

​8. メンバー使用制限取得

​パスパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​9. メンバー使用制限更新

​パスパラメータ

​リクエストパラメータ（JSON）

​リクエスト例

​成功レスポンス（200 OK）

​10. メンバー使用制限の解除

​パスパラメータ

​成功レスポンス（200 OK）

​エラーコード

​使用例

​メンバー一覧

​メールでメンバー検索

​メンバー一覧（削除済みを含む）

​メンバー詳細取得

​メンバー統計取得

​メンバー削除

​メンバー Add-On Cap 更新

​メンバークォータ取得

​メンバー Add-On Cap 一括更新

​メンバー使用制限取得

​メンバー使用制限更新

​メンバー使用制限の解除

このドキュメントについて

前提条件

API 一覧

1. メンバー一覧

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

2. メンバー詳細取得

パスパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

3. メンバー統計取得

パスパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

4. メンバー削除

パスパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

エラーレスポンス

5. メンバークォータ取得

パスパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

6. メンバー Add-On Cap 更新

パスパラメータ

リクエストパラメータ（JSON）

リクエスト例

成功レスポンス（200 OK）

レスポンスフィールド

エラーレスポンス

7. メンバー Add-On Cap 一括更新

パスパラメータ

リクエストパラメータ（JSON）

リクエスト例

成功レスポンス（200 OK）

レスポンスフィールド

エラーレスポンス

8. メンバー使用制限取得

パスパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

9. メンバー使用制限更新

パスパラメータ

リクエストパラメータ（JSON）

リクエスト例

成功レスポンス（200 OK）

10. メンバー使用制限の解除

パスパラメータ

成功レスポンス（200 OK）

エラーコード

使用例

メンバー一覧

メールでメンバー検索

メンバー一覧（削除済みを含む）

メンバー詳細取得

メンバー統計取得

メンバー削除

メンバー Add-On Cap 更新

メンバークォータ取得

メンバー Add-On Cap 一括更新

メンバー使用制限取得

メンバー使用制限更新

メンバー使用制限の解除