API Reference

Projects and Environments

Manage production/sandbox projects and switch active context.

Overview

Each organization can operate across production and sandbox projects. Project APIs let you create/reset sandbox state and switch active project tokens.

What You Will Learn

  • Organization-scoped project list and active project context.
  • Sandbox creation/reset semantics.
  • Token refresh behavior when switching projects.

Implementation Checklist

  • Load project context after login and before sensitive actions.
  • Use sandbox project for testing integrations safely.
  • Use project switch endpoint and replace bearer token immediately after switching.

Relevant Endpoints

GET
/v1/projects

List organization projects and active project.

POST
/v1/projects/sandbox

Create sandbox project (idempotent).

POST
/v1/projects/sandbox/reset

Reset sandbox-scoped data.

POST
/v1/projects/switch

Switch active project and return a fresh token.

Related Guides