Skip to main content

Authentication

StateSet ResponseCX provides REST and GraphQL APIs. All requests must be authenticated with an API key.
Quick Start
Authorization: Bearer ${STATESET_API_KEY}

API keys

  • Test keys (sk_test_) for sandbox development
  • Live keys (sk_live_) for production
Create keys in Dashboard → Settings → API Keys. Keys are shown only once—store them securely.
Never expose secret keys in client-side code or public repositories. Use environment variables.

Using your key

curl https://api.stateset.com/v1/agents \
  -H "Authorization: Bearer ${STATESET_API_KEY}" \
  -H "Content-Type: application/json"

Troubleshooting

  • 401 Unauthorized: missing/invalid key or wrong environment.
  • 403 Forbidden: key lacks required permissions.