Planning

Create a initiative

Create a workspace initiative that projects and epics roll up into.

post/workspaces/{workspace_slug}/initiatives/

Request

  • Base URL: https://api.plane.so/api/v1
  • URL: https://api.plane.so/api/v1/workspaces/{workspace_slug}/initiatives/
  • 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: initiatives: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
descriptionstring
description_htmlstring
leadstring uuid
statestring uuid
start_datestring date
end_datestring date
logo_propsobject

Response

The created initiative.

idstring uuid required
namestring required
description_htmlstring nullable
leadstring uuid nullable
statestring uuid nullable
start_datestring date nullable
end_datestring date nullable
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.