Managing Media API Tokens

When you use the Brightcove Media API, your method calls require a token. Tokens are issued to accounts by Brightcove and give you access to your account using the API. You append your token to the call as a URL parameter, token=<tokenString>, where tokenString is your URL-encoded token. See Getting Started with the Media API for more details about using API tokens.

Note: Media API tokens generally end with one or more dots (.). Be sure to include the dots when you use the API tokens—it's easy to lose them when you cut and paste.

Token types

There are three separate types of tokens:

• Read tokens, which provide read-only access to your Brightcove Media Library.
• Write tokens, which enable you to create, modify, or delete content in your Brightcove Media Library. Write tokens are not supported for some Brightcove account editions.
• Read tokens with URL access, which enable you to return the paths to the underlying media files and not just the media's metadata.

How to get tokens

If your Brightcove account was created after the Brightcove 3.3.2 release (August 27, 2009), a read token and a read token with URL access were automatically generated for you when your account was created. The Brightcove Studio displays your account's tokens (see Viewing your tokens). If your account was created before that, or if you need a write token or other additional tokens issued to you, contact Brightcove customer support.

Viewing your tokens

The Account Settings: API Management page in the Brightcove Studio displays all the tokens issued to your account. This page is accessible only by users with the Admin role.

You can click the copy link to copy a token to your clipboard, or click the email link to create an email message that includes the token in its body.

Creating or deactivating a token

If you require additional tokens, or need to deactivate existing tokens, please contact Brightcove customer support.