# Update a VerificationSession

Updates a VerificationSession object.

When the session status is `requires_input`, you can use this method to update the verification check and options.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. createIdentityVerificationSession
POST /v1/identity/verification_sessions {"type":"document"}

## Request

```curl
curl https://api.stripe.com/v1/identity/verification_sessions/{{VERIFICATION_SESSION_ID}} \
  -u "<<YOUR_SECRET_KEY>>" \
  -d type=id_number
```

### Response

```json
{
  "id": "vs_1NuN9WLkdIwHu7ix597AR9uz",
  "object": "identity.verification_session",
  "client_secret": "...",
  "created": 1695680478,
  "last_error": null,
  "last_verification_report": null,
  "livemode": false,
  "metadata": {},
  "options": {},
  "redaction": null,
  "status": "requires_input",
  "type": "id_number",
  "url": "..."
}
```

## Returns

Returns the updated VerificationSession object

## Parameters

- `metadata` (map, optional)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.

- [`options`](https://docs.stripe.com/api/identity/verification_sessions/update.md?query=options) (object, optional)
  A set of options for the session’s verification checks.

- [`provided_details`](https://docs.stripe.com/api/identity/verification_sessions/update.md?query=provided_details) (object, optional)
  Details provided about the user being verified. These details may be shown to the user.

- `type` (enum, optional)
  The type of [verification check](https://docs.stripe.com/identity/verification-checks.md) to be performed.
Possible enum values:
  - `document`
    [Document check](https://docs.stripe.com/identity/verification-checks.md?type=document).

  - `id_number`
    [ID number check](https://docs.stripe.com/identity/verification-checks.md?type=id-number).