Projects are the general place for collaboration in Rise. They can be used for capturing and organizing tasks. A user of Rise can create private projects to organize tasks or share it to work together with their team.

Projects are identified by a UUID and are represented by the following fields in our public API:

{
  "uuid": "",             # The unique identifier of the project
  "workspace_uuid": "",   # The unique identifier of the workspace
  "team_uuid": "",        # The unique identifier of the team
  "name": "",             # The name of the project
}

GET /projects

Retrieves all projects the currently authenticated user belongs to

curl -H 'Authorization: Bearer TOKEN' <https://api.risecalendar.com/v1/projects>

Response

[
	{
	  "uuid": "53dcb3f5-539e-4d2e-9143-009e1b01ef01",
	  "workspace_uuid": "9620cdee-09d5-4d88-a706-18ef8b945381",
	  "team_uuid": "b6419b9a-1e15-4c04-a608-501e0a89b429",
	  "name": "September onsite"
	}
]

POST /projects

Creates a new project

curl --request POST \\
  --url <https://api.risecalendar.com/v1/projects> \\
  --header 'Authorization: Bearer TOKEN' \\
  --header 'Content-Type: application/json' \\
  --data '{
	"name": "September onsite",
	"workspace_uuid": "9620cdee-09d5-4d88-a706-18ef8b945381",
	"team_uuid": "b6419b9a-1e15-4c04-a608-501e0a89b429",
	"project_template_uuid": "ea34d725-36f3-42e8-9fe5-d37e249b17db"
}'

Request body

{
  "name": "September onsite", # Name of the project
  "workspace_uuid": "9620cdee-09d5-4d88-a706-18ef8b945381", # Nullable. Workspace of the project. If none is provided we use the default workspace
  "team_uuid": "b6419b9a-1e15-4c04-a608-501e0a89b429", # Nullable. Team of the project. If none is provided it will be visibile for the whole workspace
  "project_template_uuid": "ea34d725-36f3-42e8-9fe5-d37e249b17db", # Nullable. Project Template to be applied to the project
}

Response

{
  "uuid": "53dcb3f5-539e-4d2e-9143-009e1b01ef01",
  "workspace_uuid": "9620cdee-09d5-4d88-a706-18ef8b945381",
  "team_uuid": "b6419b9a-1e15-4c04-a608-501e0a89b429",
  "name": "September onsite"
}

PATCH /projects/:project_uuid

Updates an existing project

curl --request PATCH \\
  --url <https://api.risecalendar.com/v1/projects/53dcb3f5-539e-4d2e-9143-009e1b01ef01> \\
  --header 'Authorization: Bearer TOKEN' \\
  --header 'Content-Type: application/json' \\
  --data '{
	"name": "September onsite",
	"project_template_uuid": "ea34d725-36f3-42e8-9fe5-d37e249b17db"
}'

Request body

{
  "name": "September onsite", # Name of the project
  "project_template_uuid": "ea34d725-36f3-42e8-9fe5-d37e249b17db", # Nullable. Project Template to be applied to the project
}