Plane DocsSign in

Overview ​

An initiative is a high-level strategic goal. It groups related work across projects, epics, and work items so you can organize it and measure progress toward a larger objective.

Learn more about initiatives

The initiative object ​

Attributes ​

  • id uuid

    Unique identifier for the initiative

  • name string (required)

    Name of the initiative

  • description string

    Plain text description of the initiative

  • description_html string

    HTML description of the initiative

  • description_stripped string

    The description as plain text, with HTML removed

  • description_binary string

    Binary description of the initiative

  • lead uuid

    User ID of the initiative lead

  • start_date date

    Start date of the initiative in YYYY-MM-DD format

  • end_date date

    End date of the initiative in YYYY-MM-DD format

  • logo_props object

    Logo properties for the initiative

  • state string

    State of the initiative: DRAFT, PLANNED, ACTIVE, COMPLETED, or CLOSED

  • workspace uuid

    ID of the workspace the initiative belongs to. Set automatically.

  • created_at timestamp

    The timestamp when the initiative was created

  • updated_at timestamp

    The timestamp when the initiative was last updated

  • created_by uuid

    ID of the user who created the initiative

  • updated_by uuid

    ID of the user who last updated the initiative

Response200
json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2023-11-19T11:56:55.176802Z",
  "updated_at": "2023-11-19T11:56:55.176809Z",
  "name": "Q1 Product Launch",
  "description": "Launch new product features in Q1",
  "description_html": "<p>Launch new product features in Q1</p>",
  "lead": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "start_date": "2024-01-01",
  "end_date": "2024-03-31",
  "state": "ACTIVE",
  "workspace": "cd4ab5a2-1a5f-4516-a6c6-8da1a9fa5be4"
}