projects

Create a Project.

post/projects

Request

  • Base URL: https://restivity.ai/api/v1
  • URL: https://restivity.ai/api/v1/projects
  • Auth: OAuth 2 (authorization code, authorization URL https://restivity.ai/oauth/authorize, token URL https://restivity.ai/api/oauth/token, scopes: projects:write)

Request body

namestring required
descriptionstring

A project description is plain text, at most 10,000 characters: marked text (**bold**, - and 1. lists, `code`, links) or HTML is accepted and stored as its words — markers and tags removed, list items kept as - / 1. lines — so a project card shows no asterisks, backticks or tags

colorstring
is_archivedboolean
team_idstring uuid nullable
prefixstring nullable

Project key (2–5 uppercase letters/digits, leading letter) — task codes become KEY-1, KEY-2… Optional: when omitted, the server derives a unique key from the name (e.g. "Launch Plan" → LAU, or LAUN when LAU is taken). Reserved keys are refused.

Response

The created Project.

idstring uuid required
user_idstring uuid required
namestring required
descriptionstring required
colorstring required
is_archivedboolean required
team_idstring uuid nullable required
prefixstring nullable required
task_counterinteger required
created_atstring required
updated_atstring required
deleted_atstring nullable required
urlstring
scopestring
firestore_idstring nullable
team_namestring nullable
team_slugstring nullable
task_countinteger
completed_task_countinteger
overdue_task_countinteger
next_due_datestring nullable
is_agent_inboxboolean
workspace_idstring uuid nullable
workspace_short_idstring nullable
workspace_slugstring nullable
team_short_idstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.