POST/partners/customers/{domainId}/usage-status/renewal

最大ユーザー数 (maxMemberCount) の変更を予約設定する。

  • 予約適用日 (applyDate) は 翌日から 1 年後まで設定できる。

Authorization

oauth2

Access Token を指定します。 指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

partner

HTTP Request

POSThttps://www.worksapis.com/v1.0/partners/customers/{domainId}/usage-status/renewal

Path Parameters

ParameterTypeDescription
domainId integer 

ドメイン ID


required
example : 10000001 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

PropertyTypeDescription
applyDate string 

予約適用日

  • 翌日以降、1 年後まで

required
format : date 
maxMemberCount integer 

適用する最大ユーザー数

  • null の場合には制限なし
  • 最大で 1,000,000 まで指定できる

maximum : 1000000
nullable : true 

Request Example

2025-02-15 に 顧客企業の最大ユーザー数を 100 人で予約設定する

1{2  "applyDate": "2025-02-15",3  "maxMemberCount": 1004}

Response

HTTP 201

OK

PropertyTypeDescription
domainId integer 

ドメイン ID

 
status string 

顧客企業の状態

  • ACTIVE : 正常
  • SUSPENDED_ADMIN : 停止 (管理者による停止)
  • SUSPENDED_WITHDRAWAL :停止 (脱退待機による停止)

Allowed values : ACTIVE, SUSPENDED_ADMIN, SUSPENDED_WITHDRAWAL 
memberCount integer 

利用ユーザー数

 
maxMemberCount integer 

最大ユーザー数


nullable : true 
withdrawalDate string 

解約日

  • 契約ステータス (status) が解約待機による停止 (SUSPENDED_WITHDRAWAL) の場合、顧客企業の削除 (解約) 日付
  • その他のステータス (status) の場合は null

format : date
nullable : true 
renewal object (renewal) 

予約情報

 

renewal

PropertyTypeDescription
maxMemberCount integer 

最大ユーザー数


nullable : true 
applyDate string 

予約適用日


required
format : date 

Response Example

Example 1

1{2  "domainId": 0,3  "status": "ACTIVE",4  "memberCount": 0,5  "maxMemberCount": 0,6  "withdrawalDate": "2019-08-24"7}