Back to Help

api

API Authentication

Authenticate requests with API keys and understand auth priority behavior.

Audience: developer

Supported Auth Methods

SlideVids API supports:

  1. x-api-key header (recommended for automation)
  2. Authorization: Bearer <jwt> (useful for interactive flows)

Server auth priority is API key first, then bearer token, then session cookie.

API Key Example

export SLIDEVIDS_API_KEY="sv_live_xxx"

curl -s https://api.slidevids.com/v1/me \
  -H "x-api-key: $SLIDEVIDS_API_KEY"

Bearer Token Example

export SLIDEVIDS_TOKEN="eyJ..."

curl -s https://api.slidevids.com/v1/me \
  -H "Authorization: Bearer $SLIDEVIDS_TOKEN"

Common Auth Errors

  • 401 when credentials are missing/invalid.
  • 403 when the account tier does not allow API access.
  1. Store API keys in env vars or secret managers.
  2. Never hardcode credentials in source control.
  3. Log request IDs from error responses for support/debugging.