Authentication, scopes, and rate limits

Every /integrations/v1 request requires an explicit Bearer value:

curl https://api.getramon.com/integrations/v1/context \
  --header "Authorization: Bearer YOUR_INTEGRATION_KEY"

Missing, malformed, revoked, or unknown credentials return 401 Unauthorized. Ramon's integration keys are organization-scoped, so a valid key cannot access a survey mapping owned by a different organization.

Rate limit

Ramon permits 120 Integration API requests per key per minute. Additional requests return 429 with:

Retry-After: 60

Respect Retry-After, apply bounded exponential backoff with jitter to transient requests, and avoid unbounded parallel polling. A request that has already started a scoring run may return the existing active run rather than creating a second one.