Planning

Create a epic

Create an epic to parent a body of related work items.

post/workspaces/{workspace_slug}/projects/{project_id}/epics/

Request

  • Base URL: https://api.plane.so/api/v1
  • URL: https://api.plane.so/api/v1/workspaces/{workspace_slug}/projects/{project_id}/epics/
  • 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.epics:write)

Path parameters

workspace_slugstring required

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

project_idstring uuid required

The project the resource belongs to.

Request body

namestring required
description_htmlstring
state_idstring uuid
parent_idstring uuid
priority'urgent' | 'high' | 'medium' | 'low' | 'none'
assignee_idsstring[]
label_idsstring[]
start_datestring date
target_datestring date
estimate_pointstring uuid
external_sourcestring
external_idstring

Response

The created epic.

idstring uuid required
namestring required
description_htmlstring nullable
state_idstring uuid nullable
parent_idstring uuid nullable
priority'urgent' | 'high' | 'medium' | 'low' | 'none'
assignee_idsstring[]
label_idsstring[]
start_datestring date nullable
target_datestring date nullable
created_atstring date-time
updated_atstring date-time

Changes

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