> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: authorize(token: string, options: AuthorizeOptions)

# Method package: wixCaptchaV2

# Method menu location: wixCaptchaV2 --> captcha --> authorize

# Method Link: https://dev.wix.com/docs/velo/apis/wix-captcha-v2/captcha/authorize.md

# Method Description:

Authorizes a CAPTCHA token.

Following CAPTCHA verification on the client side, you must authorize the generated CAPTCHA
token in the backend.

`Authorize` checks if the token is valid, making sure it was not tampered with or timed out.

If you're developing a Wix site or Blocks app, call this method when working with the
[Wix reCAPTCHA](https://dev.wix.com/docs/velo/api-reference/$w/captcha/introduction.md) element.

If CAPTCHA token authorization fails, the method returns an error message containing a status code.
The following table lists the possible HTTP error status codes, based on
[RFC 2616](https://datatracker.ietf.org/doc/html/rfc2616#section-10):


| Status Code | Name | Description |
|---|---|---|
| 400 | Bad Request | The request could not be understood by the server. This could occur for a number of reasons, such as: <ul> <li>The request was sent without a token.</li> <li>The token is invalid.</li> <li>The token has timed out.</li> </ul> |
| 401 | Unauthenticated | No user identity found in passed request. |
| 500 | Internal Server Error | The server encountered an unexpected condition, such as a missing or invalid private CAPTCHA key. |
| 503 | Unavailable | The service is unavailable due to one of the following: <ul> <li>Throttled error: Server overload due to more than the allowed requests in a given time frame.</li> <li>Request failed: No response following 10 retries with a 1-second interval.</li> </ul> |



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## authorize example for dashboard page code

```javascript
import { captcha } from 'wix-captcha.v2';

async function authorize(token, options) {
  try {
    const result = await captcha.authorize(token, options);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

```

## authorize example for exporting from backend code

```javascript
import { captcha } from 'wix-captcha.v2';
import { webMethod, Permissions } from 'wix-web-module';
import { elevate } from 'wix-auth';

const elevatedAuthorize = elevate(captcha.authorize);

export const authorize = webMethod(
  Permissions.Anyone,
  async (token, options) => {
    try {
      const result = await elevatedAuthorize(token, options);
      return result;
    } catch (error) {
      console.error(error);
      // Handle the error
    }
  }
);

```

---