POST `/admin/billing/subscription/{tenant_id}/extend-trial`

Extend the free trial period of the current subscription for a specified tenant (in days). After successful extension, a trial expiration reminder notification is sent.

Billing Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`tenant_id`	`path`	`string`	Yes				Tenant ID

Request Body

Schema: dto.ExtendTrialRequest

Field	Type	Required	Example	Constraints	Description
`extend_days`	`integer`	Yes	`14`

Responses

Status	Description	Schema
200	Trial period extended successfully	`dto.TrialActionDetailResponse`
400	Invalid request parameters	`object`
401	Unauthorized	`object`
403	No permission	`object`
500	Internal server error	`object`

Referenced Schemas

dto.TrialActionDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.TrialActionResult`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.TrialActionResult

Field	Type	Required	Example
`message`	`string`	No	`Trial period extended by 14 days`
`plan`	`string`	No	`pro`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_xyz789`
`trial_end_date`	`string`	No	`2026-06-01T00:00:00Z`

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /admin/billing/subscription/{tenant_id}/extend-trial