Docs

Workspaces

Organize infrastructure by environment and keep uploads consistent.

Workspaces let you separate environments like dev, staging, and prod. Cora uses workspace names to organize diagrams and history.

How workspaces are selected

When you upload state, Cora determines the workspace in this order:

X-Cora-Workspace header
?workspace=<name> query parameter
workspace field in the JSON payload
Terraform state workspace metadata
Default workspace

Recommended naming

Use a consistent naming scheme so diagrams stay easy to scan.

Examples:

networking-prod
app-staging
platform-dev

Example upload

bash

terraform state pull | cora upload --workspace networking-prod

Next steps

Automate uploads in your CI pipeline.
Integrate with Atlantis for post-apply uploads.
Filter sensitive data before uploading.