Planning

Create a cycle

Create a time-boxed cycle. Cycles in one project cannot overlap.

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

Request

  • Base URL: https://api.plane.so/api/v1
  • URL: https://api.plane.so/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/
  • 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.cycles: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
descriptionstring
start_datestring date
end_datestring date
owned_bystring uuid
timezonestring
external_sourcestring
external_idstring

Response

The created cycle.

idstring uuid required
namestring required
descriptionstring nullable
start_datestring date nullable
end_datestring date nullable
status'draft' | 'upcoming' | 'current' | 'completed'
owned_bystring uuid
projectstring uuid
created_atstring date-time
updated_atstring date-time

Changes

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