Access Tokens

Manage your access tokens to authenticate requests with Faceware Portal. Faceware Portal authenticates your API requests using your account’s access tokens. If you don’t include your token when making an API request, or use an incorrect or outdated one, Faceware Portal returns an error.

Obtaining your Access Tokens

Your access tokens can be managed and created on your organization settings page, under "Manage API Access Tokens" section:

Keeping your tokens safe

Your access tokens can be used to make API calls on behalf of your account. Treat your access token as you would any other password. Grant access only to those who need it. Ensure it is kept out of any version control system you may be using.

Tip

Control access to your token using a password manager or secrets management service.

Rotating Keys

If an access token is compromised, rotate the token in the organization settings page to block it and generate a new one.

When you rotate an access token, the old token will be blocked immediately, so any systems currently using that token will experience downtime.

Organization ID

You will need your account organization ID to make API requests. This can be found on your organization settings page, under the "General" section:

Project ID

All jobs submitted for processing require a project ID. To find the project ID, go to the projects list page and click the copy icon next to your project name:

Warning

Disabled projects will not accespt jobs. Faceware Portal will respond with an error if a job is submitted to a disabled project.