Terraform projects

fireweave_project manages a Fireweave project in the organisation that owns your API key. A project is the top-level container for environments, integrations, and rollouts. Terraform creates and updates it through GET / POST /v1/projects and GET / PATCH / DELETE /v1/projects/{projectID}. Generated schema: fireweave_project on the Terraform Registry.

Example

resource "fireweave_project" "app" {
  name        = "Payments Service"
  slug        = "payments"
  description = "Checkout and billing services"
  status      = "active"
}

slug must be unique within the organisation. Changing it forces a new resource.

Arguments

Name	Type	Required	Notes
`name`	String	Yes	Human-readable project name. Updates in place.
`slug`	String	Yes	URL-safe slug, unique within the organisation. Forces replacement.
`description`	String	No	Longer description.
`status`	String	No	`active` or `archived`. Optional + computed. Defaults to `active`.

Read-only

Name	Type	Notes
`id`	String	Project identifier assigned by Fireweave. Use this for import.

The API also returns createdAt and updatedAt. Those fields are not Terraform attributes.

Status

Leave status unset and the provider defaults it to active. Set archived to archive the project. On create, if you set a status other than the API create default, the provider creates the project and then PATCHes status.

Import

Import by project id:

terraform import fireweave_project.app <project_id>

After import, run terraform plan and align name, slug, description, and status with the remote project so the next apply is a no-op.

Look up a project you do not manage

Use the fireweave_project or fireweave_projects data source when another workspace (or the console) already owns the project. See Data sources.

Environments

Attach stage and prod environments to fireweave_project.app.id.

Data sources

Look up a project by id or slug.

Last modified on September 11, 2026

Get Started

SDKs

Concepts

Production

CLI

Terraform

Testing

Troubleshooting

Migration

Reference

Terraform projects

Example

Arguments

Read-only

Status

Import

Look up a project you do not manage

Next

Environments

Data sources

​Example

​Arguments

​Read-only

​Status

​Import

​Look up a project you do not manage

​Next

Environments

Data sources

Example

Arguments

Read-only

Status

Import

Look up a project you do not manage

Next