Skip to main content
The project command helps you create, list, describe, and manage projects in Xata.

​
Subcommands

​
list

List all projects.
​
string
Organization ID (default: "")
​
boolean
Output in JSON format (default: false)
​
boolean
Print help information and exit
Aliases: ls

​
describe

Describe a project.
​
string
Organization ID (default: "")
​
string
Project ID (default: "")
​
boolean
Output in JSON format (default: false)
​
boolean
Print help information and exit
Aliases: view, show

​
create

Create a new project.
​
string
Organization ID (default: "")
​
string
required
Project Name
​
string
Branch Name (default: "")
​
string
Type of instance for this branch (default: "")
​
number
Number of replicas for the branch (0-4, default: "")
​
string
Region for the branch (default: "")
​
boolean
Default scale to zero status for base branches (true|false)
​
boolean
Default scale to zero status for child branches (true|false)
​
number
Default inactivity period in minutes for base branches (15|30|60|120|180)
​
number
Default inactivity period in minutes for child branches (15|30|60|120|180)
​
boolean
Output in JSON format (default: false)
​
boolean
Print help information and exit

​
delete

Delete a project.
​
string
Organization ID (default: "")
​
string
Project ID (default: "")
​
boolean
Output in JSON format (default: false)
​
boolean
Do not ask for confirmation, assume yes (default: false)
​
boolean
Print help information and exit

​
init

Link a project to the folder.
​
string
Organization ID (default: "")
​
string
Project ID (default: "")
​
string
Branch ID (default: "")
​
string
Database name (default: "")
​
boolean
Output in JSON format (default: false)
​
boolean
Print help information and exit
Aliases: connect, switch, link

​
get

Get a field from a project description.
​
string
Organization ID (default: "")
​
string
Project ID (default: "")
​
string
required
The field to get (default: .catalog)
​
boolean
Print help information and exit

​
set

Set a field value for a project.
​
string
Organization ID (default: "")
​
string
Project ID (default: "")
​
string
required
The field to set
​
string
required
The value to set
​
boolean
Print help information and exit

​
Global Flags

​
boolean
Print help information and exit
​
boolean
Output in JSON format