Authentication

Every request needs a secret key in the Authorization header.

Authorization: Bearer sk_live_...

Create and revoke keys under Channels, API keys. The key is shown once, at creation; only a hash is stored, so a lost key must be replaced rather than recovered.

curl https://www.marketmind.skotechlabs.com/api/v1/usage \
  -H "Authorization: Bearer sk_live_..."

Scope

A key belongs to one workspace and can only ever see that workspace data. Every query is scoped automatically, so there is no way to read another workspace rows even by guessing an id.

Rate limits

Requests per minute are set by the plan (30 on trial, up to 600 on Agency). Over the limit you get 429 with a Retry-After header.

Errors

Every error has the same shape:

{
  "error": {
    "type": "invalid_request",
    "message": "An email or a phone number is required."
  }
}