Skip to main content

Create a project plan task

POST 
/api/project-plan-tasks

Required permissions:

  • project_plan.edit: allows the creation of project plan tasks.

Custom fields​

Set single-option custom fields using dynamic fields named like custom_field_55 where 55 is the ID of the custom field; the value is the ID of the option to select, or null to leave it unset. Only single-option custom fields are supported.

Request​

Header Parameters

    Wethod-Company stringrequired

    The company you want to interact with

    Wethod-Version stringrequired

    The API version you want to use

Body

    project_plan_area_id integerrequired

    The ID of the project plan area this task belongs to

    name stringrequired

    Possible values: <= 255 characters

    The name of the project plan task

    notes stringnullable

    Free-form notes attached to the task

    start_date datenullable

    The start date of the task, formatted as YYYY-MM-DD

    end_date datenullable

    The end date of the task, formatted as YYYY-MM-DD

    depends_on_id integernullable

    The ID of the task this task depends on, if any

    dependency_type stringnullable

    Possible values: [start-to-start, finish-to-start, start-to-finish, finish-to-finish]

    The dependency type between this task and the one it depends on

    status_key stringnullable

    Possible values: [not-started, in-progress, blocked, done, closed]

    The status of the task

Responses​

Returns the project plan task created.

Schema

    id integerrequired

    Possible values: >= 1

    The unique identifier of the resource

    created_at date-timerequired

    The date and time when the resource was created

    updated_at date-timerequired

    The date and time when the resource was last updated

    name stringrequired

    Possible values: <= 255 characters

    The name of the project plan task

    sort floatrequired

    The sort order of the task within its area

    project_plan_area_id integerrequired

    Possible values: >= 1

    The ID of the project plan area this task belongs to

    budget_task_id integernullable

    Possible values: >= 1

    The ID of the budget task linked to this project plan task, if any

    start_date datenullable

    The start date of the task, formatted as YYYY-MM-DD

    end_date datenullable

    The end date of the task, formatted as YYYY-MM-DD

    notes stringnullable

    Free-form notes attached to the task

    status_key stringnullable

    Possible values: [not-started, in-progress, blocked, done, closed]

    The status of the task

    depends_on_id integernullable

    Possible values: >= 1

    The ID of the task this task depends on, if any

    dependency_type stringnullable

    Possible values: [start-to-start, finish-to-start, start-to-finish, finish-to-finish]

    The dependency type between this task and the one it depends on

Loading...