Configure the provider
Add the provider to your Terraform configuration:INTERFERE_TOKEN. App management requires these scopes:
org:surfaces:readorg:surfaces:writeorg:surfaces:delete
Manage workspace settings
Useinterfere_workspace to manage an existing workspace’s name and slug:
org:workspace_basics:read and org:workspace_basics:write for this resource.
Create an app
terraform.tfvars:
terraform.tfvars
acme with your workspace slug and generate a nonzero UUID for this app. Keep that UUID stable across plans and retries; do not use uuid() to generate a different value on every run.
id and slug. App creation also issues default credentials. Manage SDK and build credentials on the app in Interfere. They are not stored in Terraform state.
Update or replace an app
Review a replacement plan before applying it. Deleting a resource from configuration causes Terraform to request deletion of the managed app.
Supported framework values are
elysia, nest, nextjs, python, and react.
Import an existing app
Add a matching resource block, then import with the workspace and app slugs:Manage private API keys
Useinterfere_private_key for a workspace automation key or an app build key. Set surface_slug to scope a key to an app; omit it for a workspace key.
org:workspace_auth:read and org:workspace_auth:write. For app keys, it needs org:surfaces:read and org:surfaces:write. The credential must also be allowed to grant the requested scopes.
The example expires after 30 days. Omit seconds_until_expiration or set it to null for no expiry. Changing grants or lifetime replaces the key, so choose a fresh creation UUID for the replacement.
The resource’s secret output is sensitive and is stored in Terraform state. Use a state backend with access controls appropriate for credentials. Import restores metadata only; it cannot recover the secret.