## RegenerateSCIMToken

`organizations.scim_configurations.regenerate_token(ScimConfigurationRegenerateTokenParams**kwargs)  -> ScimConfigurationRegenerateTokenResponse`

**post** `/gitpod.v1.OrganizationService/RegenerateSCIMToken`

Regenerates the bearer token for a SCIM configuration.

Use this method to:

- Rotate SCIM credentials
- Recover from token compromise
- Update IdP configuration

### Examples

- Regenerate token:

  Creates a new bearer token with the same expiration duration as the previous token.

  ```yaml
  scimConfigurationId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
  ```

- Regenerate token with new expiration:

  Creates a new bearer token with a custom 180-day expiration.

  ```yaml
  scimConfigurationId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
  tokenExpiresIn: "15552000s"
  ```

### Parameters

- `scim_configuration_id: str`

  scim_configuration_id is the ID of the SCIM configuration to regenerate token for

- `token_expires_in: Optional[str]`

  token_expires_in is the duration until the new token expires.
  If not specified, uses the same duration as the previous token.

### Returns

- `class ScimConfigurationRegenerateTokenResponse: …`

  - `token: str`

    token is the new bearer token for SCIM API authentication.
    This invalidates the previous token - store it securely.

  - `token_expires_at: datetime`

    token_expires_at is when the new token will expire

### Example

```python
import os
from gitpod import Gitpod

client = Gitpod(
    bearer_token=os.environ.get("GITPOD_API_KEY"),  # This is the default and can be omitted
)
response = client.organizations.scim_configurations.regenerate_token(
    scim_configuration_id="d2c94c27-3b76-4a42-b88c-95a85e392c68",
)
print(response.token)
```

#### Response

```json
{
  "token": "token",
  "tokenExpiresAt": "2019-12-27T18:11:19.117Z"
}
```