Skip to content

Help — Using the Softwares Licenses API

If you’re integrating or using the API and need assistance, this page gives you the fastest path to a solution.

Where to start

  • Overview — high-level explanation of what the API does and when to use it.
  • Guides — step-by-step examples (activation, deactivation, admin tasks).
  • Reference — complete list of endpoints and fields.

Quick troubleshooting

  • 401/403 (auth): check you’re sending the right header:
  • Client calls → X-Client-Token: <token>
  • Admin calls → X-Admin-Token: <token>
  • 404: the license or resource doesn’t exist (or wrong email for that license).
  • 409 (activation limit): the license has reached its device quota — deactivate one device, then activate the new one.
  • 429 (rate limit): too many recent requests — slow down briefly and retry.
  • Signature validation: fetch the public key from /public-key and verify the sig field of the token returned by /activate.

Contact support

Still stuck or have a special case? Email support@flightdeck.com.
We’ll help you diagnose the issue and get unblocked.

What to include for a faster resolution

  • Your product name and environment (dev/staging/prod)
  • The endpoint you called and full HTTP status code
  • A short description of the problem and what you expected
  • The timestamp (with timezone)
  • Any relevant identifiers: email, license key (or its hash), device_name, device_hash
  • Optional: a minimal cURL that reproduces the issue (with secrets redacted)

Privacy note: avoid sharing real license keys if possible; hash or partially mask them when you email us.

FAQ

Can I move a license to a new machine?
Yes — deactivate the old device, then activate on the new one.

Why do I see “license disabled”?
An admin suspended the license; contact support or your admin to re-enable it.

Do tokens expire?
Yes — the /activate response includes expires_at. Request a fresh activation when needed.