The Regenerate Token API for Chargeback allows you to regenerate authentication tokens with a specified expiration date. This endpoint is part of the Optimus platform and provides a secure way to refresh API tokens while maintaining authentication integrity.
Note: The Regenerate Token API is used to regenerate only. Use the Chargeback Dashboard to easily generate token in the Chargeback Dashboard. For more information, refer to Generate Token on Chargeback Dashboard
Environment
| Production | <Optimus endpoint>/api/v1/tokens/regenerate |
Contact for Optimus endpoint: Contact your WIBMO key account manager or support for the Optimus endpoint.
Request header
| Header | Description | Example |
|---|---|---|
X-Optimus-API-Key mandatory | String- The unique API key for authentication | your_api_key_here |
Content-Typemandatory | string - Must be set to application/json | application/json |
Request parameters
| Parameter | Description | Example |
|---|---|---|
expires_at mandatory |
String mandatory - Specifies the expiration date for the regenerated token. Must be in YYYY-MM-DD format and cannot be a past date. Note: The valid date format is YYYY-MM-DD. |
* 2025-12-21 * 2025-12-21 * 2025-01-15 * 2024-12-31 |
Sample request
curl --location 'http://localhost:3000/api/v1/tokens/regenerate' \
--header 'X-Optimus-API-Key: {your_old_api_key}' \
--header 'Content-Type: application/json' \
--data '{ "expires_at": "2025-12-21" }'Sample response
Success scenario
{
"success": true,
"message": "Token regenerated successfully",
"token": "78fe93bd_5fc3_4df2_a54a_e04fdfbce95e",
"name": "test api token",
"expires_at": "2025-11-26 23:59:59"
}Failure scenarios
- 400 Bad Request: Invalid request format or parameters
{
"error": "Invalid expiry date format",
"message": "Expiry date must be in YYYY-MM-DD format"
}- 401 Unauthorized: Missing or invalid API key
{
"errors": "Invalid Token"
}Response parameters
HTTP Status Codes
| Status Code | Description |
|---|---|
| 200 | OK - Token regenerated successfully |
| 400 | Bad Request - Invalid request format or parameters |
| 401 | Unauthorized - Missing or invalid API key |