Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

Updated May 8, 2026 The raff project command group manages projects — the access-control unit that owns every resource. See Team & Projects — Projects for the model.

​
Subcommand index

SubcommandWhat it does
listList every project in the account
getShow details for one project
createCreate a new project
updateRename or change description
deleteDelete an empty project

​
list

raff project list [--output table|json]
List every project the API key has visibility into. Owner-level keys see all; project-only keys see only their assigned projects.

​
get

raff project get <project-id> [--output table|json]
Show details for one project — name, description, default region, member count, created-at, the Default badge if applicable.

​
create

raff project create \
  --name <name> \
  [--description <text>] \
  [--default-region us-east]
Create a new project. Default region is us-east if omitted. Project names must be unique per account. 
raff project create --name "customer-acme" --description "ACME Corp's whitelabel deployment"

​
update

raff project update <project-id> [--name <new-name>] [--description <text>]
Rename or change the description. The project’s identifier and slug stay stable; automation referencing the project by UUID is unaffected.

​
delete

raff project delete <project-id>
Delete an empty project. Fails if any resources still belong to it. The Default project cannot be deleted, ever — see Edit or delete a project for the rules.

​
Permission notes

CommandRequired permission
list, getaccount.projects.view (Owner, Admin, Member all have it)
createaccount.projects.create (Owner, Admin)
updateaccount.projects.manage (Owner, Admin)
deleteaccount.projects.delete (Owner only by default; Admin does NOT include this)
If you get 403 Forbidden, the key’s role doesn’t include the permission for that action.

VM commands

Use —project-id to scope VM operations.

Roles, scopes, and the Owner

Why delete may 403 even on Admin keys.

Permissions matrix

Which role grants which account.projects.* permission.
Last modified on May 8, 2026