Projects

Create a project

Create a project. identifier becomes the prefix of every work item id in it and cannot be reused within the workspace.

post/workspaces/{workspace_slug}/projects/

Request

  • Base URL: https://api.plane.so/api/v1
  • URL: https://api.plane.so/api/v1/workspaces/{workspace_slug}/projects/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.plane.so/auth/o/authorize-app/, token URL https://api.plane.so/auth/o/token/; client credentials, token URL https://api.plane.so/auth/o/token/, scopes: projects:write)

Path parameters

workspace_slugstring required

Workspace identifier from the workspace URL. In https://app.plane.so/my-team/projects/ it is my-team.

Request body

namestring required
identifierstring required

Short prefix for work item identifiers, e.g. ENG.

descriptionstring
project_leadstring uuid
default_assigneestring uuid
emojistring
icon_propobject
cover_imagestring uri
timezonestring

IANA timezone name.

cycle_viewboolean
module_viewboolean
issue_views_viewboolean
page_viewboolean
intake_viewboolean
guest_view_all_featuresboolean
archive_ininteger

Months of inactivity before completed work is auto-archived.

close_ininteger

Months of inactivity before work is auto-closed.

is_issue_type_enabledboolean
is_time_tracking_enabledboolean
external_sourcestring
external_idstring

Response

The created project.

idstring uuid required
namestring required
identifierstring required

Short prefix used in work item identifiers, e.g. ENG.

descriptionstring nullable
network0 | 2

0 private to members, 2 visible to the whole workspace.

project_leadstring uuid nullable
default_assigneestring uuid nullable
timezonestring
cycle_viewboolean
module_viewboolean
page_viewboolean
intake_viewboolean
is_time_tracking_enabledboolean
archived_atstring date-time nullable
created_atstring date-time
updated_atstring date-time

Changes

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