task
task

Update a task

Changed on
put/task/{connection_id}/task/{id}

Request

  • Base URL: https://api.unified.to
  • URL: https://api.unified.to/task/{connection_id}/task/{id}
  • Auth: API key in header authorization

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Task

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Request body

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring
project_idstring

(reference to TaskProject)

parent_idstring
completed_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

status'OPENED' | 'IN_PROGRESS' | 'COMPLETED'
notesstring
due_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

start_atstring date-time

Scheduled/planned start of the task (distinct from created_at) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

end_atstring date-time

Scheduled/planned end of the task (distinct from due_at and completed_at) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

prioritystring
assigned_user_idsstring[]
creator_user_idstring

The user who created this task (reference to HrisEmployee)

follower_user_idsstring[]
group_idsstring[]
tagsstring[]
urlstring
attachment_idsstring[]

Array of attachment IDs retrieved from StorageFile.Get endpoint

has_childrenboolean
typestring

The task/issue type name (e.g. Jira issue type).

time_spentnumber
time_spent_unitstring
progressnumber

0-100

story_pointsnumber
rawobject

Response

Successful

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring
project_idstring

(reference to TaskProject)

parent_idstring
completed_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

status'OPENED' | 'IN_PROGRESS' | 'COMPLETED'
notesstring
due_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

start_atstring date-time

Scheduled/planned start of the task (distinct from created_at) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

end_atstring date-time

Scheduled/planned end of the task (distinct from due_at and completed_at) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

prioritystring
assigned_user_idsstring[]
creator_user_idstring

The user who created this task (reference to HrisEmployee)

follower_user_idsstring[]
group_idsstring[]
tagsstring[]
urlstring
attachment_idsstring[]

Array of attachment IDs retrieved from StorageFile.Get endpoint

has_childrenboolean
typestring

The task/issue type name (e.g. Jira issue type).

time_spentnumber
time_spent_unitstring
progressnumber

0-100

story_pointsnumber
rawobject

Changes

  • 3bea28547cc7Revision changes
    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

  • 397324a17233Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the enum value progress to the property items/ of the query request parameter fields

    • info

      added the enum value story_points to the property items/ of the query request parameter fields

    • info

      added the enum value time_spent to the property items/ of the query request parameter fields

    • info

      added the enum value time_spent_unit to the property items/ of the query request parameter fields

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status