Skip to Content
API ReferenceAuthentication

Authentication

Getting an API key

You can create an API key on the API Integrations  page in the Ignite Admin UI. You need an admin role to access this page.

When you create a key, choose its permissions and an optional category scope.

Permissions

API key permissions are granted per resource. Enable only the actions that your integration needs.

ResourceAvailable actions
Videosread, create, update, delete, publish
Live Eventsread, create, update, delete, publish
Tagscreate, update, delete
Categoriescreate, update, delete
Analyticsread

Read access to categories and tags is always granted. You do not need to enable it.

publish is separate from create and update. For videos, setting or changing visibility to public requires videos.publish. Without it, new videos stay private and visibility updates are rejected.

Analytics endpoints require analytics.read. Video read alone is not enough. See Analytics.

API keys cannot manage members, webhooks, other API integrations, or account settings.

Category scope

You can limit an API key to one or more categories. If you select categories, the key can only access videos in those categories and their subcategories. If you leave the field empty, the key can access all categories in the workspace.

Category scope applies to videos and to per-video analytics calls. It does not limit live event access.

Using an API key

Pass your API key as a Bearer token in the Authorization header of your request.

curl -X GET https://app.ignitevideo.cloud/api/videos \ -H "Authorization: Bearer YOUR_API_KEY"