Documentation

Project Export

Download a portable JSON snapshot of a Thauth project configuration.

Open a project, choose Export, then download the JSON file.

Included

  • project identity and timestamps
  • features and actions
  • roles and role permissions
  • subjects and role assignments
  • tenant scopes and validity windows
  • subject overrides

Excluded

  • API key secrets
  • sessions and auth tokens
  • billing records
  • account users and operator identity data

Format

Exports use schema_version: "thauth.project_export.v1" and are generated directly from the current project state.

The file is hierarchical because the authorization model is hierarchical: actions belong to features, permissions belong to roles, role assignments belong to subjects, and overrides reference subject/feature/action pairs.

{
  "schema_version": "thauth.project_export.v1",
  "exported_at": "2026-04-29T12:00:00Z",
  "project": {
    "id": "project_uuid",
    "name": "Production"
  },
  "features": [],
  "roles": [],
  "subjects": [],
  "overrides": []
}

The export is not an API key backup. Generate new keys in the destination environment when migrating.