Projects

REST API methods for interacting with Phoenix projects

Create a new project

post

Create a new project with the specified configuration.

Body

namestring · min: 1Required

descriptionany ofOptional

Responses

application/json

objectOptional

text/plain

text/plain

post

HTTPcURLJavaScriptPython

POST /v1/projects HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}

{
  "data": {
    "name": "text",
    "description": "text",
    "id": "text"
  }
}

List all projects

get

Retrieve a paginated list of all projects in the system.

Query parameters

cursorany ofOptional

Cursor for pagination (project ID)

limitintegerOptional

The max number of projects to return at a time.

Default: 100

include_experiment_projectsbooleanOptional

Include experiment projects in the response. Experiment projects are created from running experiments.

Default: false

Responses

application/json

objectOptional

text/plain

text/plain

get

HTTPcURLJavaScriptPython

GET /v1/projects HTTP/1.1
Host: 
Accept: */*

{
  "data": [
    {
      "name": "text",
      "description": "text",
      "id": "text"
    }
  ],
  "next_cursor": "text"
}

Get project by ID or name

get

Retrieve a specific project using its unique identifier: either project ID or project name. Note: When using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Path parameters

project_identifierstringRequired

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Responses

application/json

objectOptional

text/plain

text/plain

text/plain

get

HTTPcURLJavaScriptPython

GET /v1/projects/{project_identifier} HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "name": "text",
    "description": "text",
    "id": "text"
  }
}

Update a project by ID or name

put

Update an existing project with new configuration. Project names cannot be changed. The project identifier is either project ID or project name. Note: When using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Path parameters

project_identifierstringRequired

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Body

descriptionany ofOptional

Responses

application/json

objectOptional

text/plain

text/plain

text/plain

put

HTTPcURLJavaScriptPython

PUT /v1/projects/{project_identifier} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "description": "text"
}

{
  "data": {
    "name": "text",
    "description": "text",
    "id": "text"
  }
}

Delete a project by ID or name

delete

Delete an existing project and all its associated data. The project identifier is either project ID or project name. The default project cannot be deleted. Note: When using a project name as the identifier, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Path parameters

project_identifierstringRequired

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Responses

text/plain

text/plain

text/plain

delete

HTTPcURLJavaScriptPython

DELETE /v1/projects/{project_identifier} HTTP/1.1
Host: 
Accept: */*

No content