Sign in Talk to our team
Products Pricing Docs Blog FAQ Contact Talk to our team
Documentation · Get started

Environments. Sandbox first, production when you're ready.

Two environments with the same API shape, different keys, separate data and explicit promotion. Pick a region at sign-up; data stays there unless you move it.

← Back to documentation

Two environments

Same surface area, different blast radius.

Sandbox
Free, isolated, no real billing.
  • Keys prefixed flx_sk_sb_.
  • 100 free pages/month, seeded with sample documents and templates.
  • Webhooks deliver from a sandbox source IP range; signatures use a sandbox secret.
  • Data is purged 90 days after last activity.
Production
Metered, audited, plan-bound.
  • Keys prefixed flx_sk_pr_.
  • Pay-per-page on your plan; cost caps enforced per tenant guard.
  • Audit trail retained per your contract (default 7 years for regulated tiers).
  • Tenant region pinned at sign-up; data stays there.

Endpoints

EnvironmentBase URLDashboard
Sandboxhttps://api.sandbox.cogneris.aiapp.cogneris.ai (Sandbox)
Productionhttps://api.cogneris.aiapp.cogneris.ai

The SDKs honour COGNERIS_BASE_URL — set it once per environment, leave the rest of your code alone.

Regions & residency

Choose where your tenant lives — data, prompts and audit trail stay in that region.

RegionPrimary locationUse when
usus-east-1 / us-central1US-only customers, no cross-border concerns.
eueu-west-1 / europe-west3EU residency for GDPR; required for EU AI Act high-risk uses.
brsa-east-1Brazil residency for LGPD; financial-data customers.
ukeu-west-2UK residency for post-Brexit data controls.

Region is set at tenant creation. Moving regions is an offline operation — open a ticket with support@cogneris.ai.

Rate limits

SurfaceSandboxProduction (default)
Extract sync60 req/min600 req/min · burst 1,200 for 30s
Extract async10 jobs/min200 jobs/min · 10,000/batch
Classify120 req/min1,200 req/min
Q&A turns30/min120/min per key
Fraud30 req/min300 req/min

All surfaces emit Retry-After on 429. Production limits are tunable on Enterprise plans.

Seed data

  • Sample documents — 12 representative PDFs across invoices, contracts, KYC and claims; downloadable from the sandbox dashboard.
  • Shipped templates — every tenant gets all 40+ templates pre-installed and updated on the standard release cadence.
  • Demo webhook receiver — sandbox tenants can route deliveries to https://app.cogneris.ai/sandbox/echo to see them rendered in the dashboard.

Promote to production

Sandbox and production are separate tenants — you don't "promote" data, you promote the configuration that produced it. The pattern that works:

  1. Pin everything — templates, validation rule sets, agent pipelines, model tiers — to specific versions in sandbox.
  2. Export the config bundle — GET /v1/tenant/config?format=bundle emits a signed manifest of every versioned object.
  3. Import in production — POST /v1/tenant/config with the bundle; objects are created at the same version pin.
  4. Swap keys — point your client at api.cogneris.ai with a flx_sk_pr_ key. The code stays the same.

Health & status

  • Health endpoint — GET /v1/health returns { status, region, version } with no auth required.
  • Status page — status.cogneris.ai publishes incidents per region and per surface.
  • SLA — production aims at 99.9% monthly uptime per region; see your contract for the live commitment.

Now ship something

Jump into the Document AI agents — Extraction is the most common starting point.

Read Extraction API