Motion Logo Motion
API Keys

Create Project

Creates a new project

POST v1 / projects

Authorization

X-API-Key string required

Header with the name X-API-Key where the value is your API key.

Body

application/json

dueDate ISO 8601 date

ISO 8601 Due date on the project, like 2024-03-12T10:52:55.714-06:00

name string required

The name of the project

workspaceId string required

The workspace to which the project belongs

description string

The description of the project. HTML input accepted

labels array<string>

The list of labels by name the project should have

priority string default: MEDIUM

Defaults to MEDIUM. Options are ASAP, HIGH, MEDIUM, and LOW

projectDefinitionId string

Optional ID of the project definition (template) to use. If provided, the `stages` array must also be included.

stages array<object>

Optional array of stage objects, required if `projectDefinitionId` is provided. Each object defines a stage in the project, including its definition ID, due date, and optionally, values for variables defined in that stage (e.g., assigning users to roles for that specific stage). Stages must match the order and number defined in the project definition. **Note:** Providing the wrong number of stages results in a 400 error with the message: `The number of stages in the project does not match the number of stages in the definition. Expected stages: [...]`.

Response

200 - application/json - object

id string required

name string required

description string required

The HTML contents of the description

workspaceId string required

The id of the workspace

status object required

The status of the project

Was this page helpful?