> For the complete documentation index, see [llms.txt](https://partner.doc.bunq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partner.doc.bunq.com/documentation/bunq-as-a-service/chapter-1-creating-a-user-provision/refreshing-the-credential-api-key.md).

# Refreshing the Credential API Key

Use the below API call in the cases where the existing `credential.token_value` is either lost, revoked, or cancelled for any reason. If user and the provision are active, you can always ask for a new token.

**Endpoint:**

```http
PUT /v1/partner-user-provision/{provision_id}
```

**Request Body:**

```json
{
    "status": "TOKEN_RESET_REQUESTED"
}
```

**Response:**

```json
{
    "Response": [
        {
            "Id": {
                "id": 123
            }
        }
    ]
}
```

**Endpoint:**

```http
GET /v1/partner-user-provision/{provision_id}
```

**Response - Token Reset is being processed:**

```json
{
    "Response": [
        {
            "PartnerUserProvision": {
                "id": 722,
                "created": "2026-06-02 07:57:43.784515",
                "updated": "2026-06-02 07:57:45.680154",
                "external_uuid": "d5d0a499-5bf2-434c-a1d6-22efc0f346e0",
                "status": "TOKEN_RESET_REQUESTED",
                "sub_status": "PENDING_PROCESS_TOKEN_RESET",
                "action_required": "SYSTEM",
                "products": [
                    "USER_VERIFIED"
                ],
                "label_user": {
                    "uuid": "2550a4a4-ff63-4d3f-ad62-6db34627e3a9",
                    "display_name": "New bunqer",
                    "country": "NL",
                    "avatar": {
                        "uuid": "37968c9e-e150-4dca-a723-d5d52058b315",
                        "image": [ ... ],
                        "anchor_uuid": "2550a4a4-ff63-4d3f-ad62-6db34627e3a9",
                        "style": "NONE"
                    },
                    "public_nick_name": "New bunqer",
                    "type": "PERSON"
                },
                "oauth_request": {
                    "uuid": "35f132f3-8d08-4835-a207-8adbe20e2908",
                    "created": "2026-06-02 07:57:44.799957",
                    "updated": "2026-06-02 07:57:44.870050",
                    "oauth_client_id": 726,
                    "oauth_client_display_name": null,
                    "response_type": "code",
                    "callback_url": "https://www.bunq.com/",
                    "status": "ACCEPTED",
                    "state": null,
                    "authorization_code": "c5082abd60006e412ccf37e877eaea40f3fedc6c6ff159f0e5fa9e44ba5ebdf8",
                    "user_alias_created": {
                        "uuid": "ca4bfe29-f849-4811-8182-6984d57e7b22",
                        "display_name": "Duck Eenmanszaak",
                        "country": "000",
                        "avatar": {
                            "uuid": "37968c9e-e150-4dca-a723-d5d52058b315",
                            "image": [ ... ],
                            "anchor_uuid": "ca4bfe29-f849-4811-8182-6984d57e7b22",
                            "style": "NONE"
                        },
                        "public_nick_name": "Duck Eenmanszaak",
                        "type": "COMPANY"
                    },
                    "redirect_url": "https://www.bunq.com/?code=c5082abd60006e412ccf37e877eaea40f3fedc6c6ff159f0e5fa9e44ba5ebdf8",
                    "type": "BUNQ"
                },
                "credential": null
            }
        }
    ]
}
```

**Endpoint:**

```http
GET /v1/partner-user-provision/{provision_id}
```

**Response - Token Reset is fully there:**

```json
{
    "Response": [
        {
            "PartnerUserProvision": {
                "id": 722,
                "created": "2026-06-02 07:57:43.784515",
                "updated": "2026-06-02 07:57:45.680154",
                "external_uuid": "d5d0a499-5bf2-434c-a1d6-22efc0f346e0",
                "status": "TOKEN_RESET_REQUESTED",
                "sub_status": "PENDING_PROCESS_TOKEN_RESET",
                "action_required": "SYSTEM",
                "products": [
                    "USER_VERIFIED"
                ],
                "label_user": {
                    "uuid": "2550a4a4-ff63-4d3f-ad62-6db34627e3a9",
                    "display_name": "New bunqer",
                    "country": "NL",
                    "avatar": {
                        "uuid": "37968c9e-e150-4dca-a723-d5d52058b315",
                        "image": [ ... ],
                        "anchor_uuid": "2550a4a4-ff63-4d3f-ad62-6db34627e3a9",
                        "style": "NONE"
                    },
                    "public_nick_name": "New bunqer",
                    "type": "PERSON"
                },
                "oauth_request": {
                    "uuid": "35f132f3-8d08-4835-a207-8adbe20e2908",
                    "created": "2026-06-02 07:57:44.799957",
                    "updated": "2026-06-02 07:57:44.870050",
                    "oauth_client_id": 726,
                    "oauth_client_display_name": null,
                    "response_type": "code",
                    "callback_url": "https://www.bunq.com/",
                    "status": "ACCEPTED",
                    "state": null,
                    "authorization_code": "c5082abd60006e412ccf37e877eaea40f3fedc6c6ff159f0e5fa9e44ba5ebdf8",
                    "user_alias_created": {
                        "uuid": "ca4bfe29-f849-4811-8182-6984d57e7b22",
                        "display_name": "Duck Eenmanszaak",
                        "country": "000",
                        "avatar": {
                            "uuid": "37968c9e-e150-4dca-a723-d5d52058b315",
                            "image": [ ... ],
                            "anchor_uuid": "ca4bfe29-f849-4811-8182-6984d57e7b22",
                            "style": "NONE"
                        },
                        "public_nick_name": "Duck Eenmanszaak",
                        "type": "COMPANY"
                    },
                    "redirect_url": "https://www.bunq.com/?code=c5082abd60006e412ccf37e877eaea40f3fedc6c6ff159f0e5fa9e44ba5ebdf8",
                    "type": "BUNQ"
                },
                "credential": {
                    "id": 3999,
                    "created": "2026-06-02 07:57:45.718390",
                    "updated": "2026-06-02 07:57:45.718390",
                    "status": "PENDING_FIRST_USE",
                    "expiry_time": "2026-06-02 08:57:45.718343",
                    "token_value": "{api_key_to_be_used}",
                    "permitted_device": null
            }
        }
    ]
}
```