Update a task status by task ID
PUT /api/2.0/project/task/{taskid:[0-9]+}/status
Request
Updates a status of a task with the ID specified in the request.
Authorization
An API key is a token that you provide when making API calls. Include the token in a header parameter called Authorization
.
Example: Authorization: 864FE52C-1C1C-469F-9308-51DAFEFE7436
.
Headers
- Accept
enum of string
Can be one of:
application/json
.- Content-Type
enum of string
Can be one of:
application/json
.
Body
- taskid
integer
Task ID
- status
integer
New task status
- statusId
integer
Custom status ID
Examples
PUT /api/2.0/project/task/%7Btaskid:[0-9]+%7D/status HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: example.com
curl --request PUT \
--url 'https://example.com/api/2.0/project/task/%7Btaskid:[0-9]+%7D/status' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Responses
200
Updated task
- Files
array of object
- Name
string
- UpdatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- Updated
string
- Location
string
- Comments
array of object
- CommentID
string
- UserID
string
uuid - UserPost
string
- UserFullName
string
- UserProfileLink
string
- UserAvatarPath
string
- CommentBody
string
- Inactive
boolean
- IsRead
boolean
- IsEditPermissions
boolean
- IsResponsePermissions
boolean
- TimeStampStr
string
- CommentList
object
- Attachments
array of object
- FileName
string
- FilePath
string
- CommentsCount
integer
int32 - IsSubscribed
boolean
- CanEditFiles
boolean
- CanCreateComment
boolean
- Project
object
- CanEdit
boolean
- CanDelete
boolean
- Security
object
- CanCreateMilestone
boolean
- CanCreateMessage
boolean
- CanCreateTask
boolean
- CanCreateTimeSpend
boolean
- CanEditTeam
boolean
- CanReadFiles
boolean
- CanReadMilestones
boolean
- CanReadMessages
boolean
- CanReadTasks
boolean
- CanLinkContact
boolean
- CanReadContacts
boolean
- CanEdit
boolean
- CanDelete
boolean
- IsInTeam
boolean
- ProjectFolder
object
- IsPrivate
boolean
- TaskCount
integer
int32 - TaskCountTotal
integer
int32 - MilestoneCount
integer
int32 - DiscussionCount
integer
int32 - ParticipantCount
integer
int32 - TimeTrackingTotal
string
- DocumentsCount
integer
int32 - IsFollow
boolean
- Tags
array of string
- Created
string
- CreatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- CreatedById
string
uuid - Updated
string
- UpdatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- UpdatedById
string
uuid - Id
integer
int32 - Title
string
- Description
string
- Status
integer
int32 - Responsible
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- ResponsibleId
string
uuid
- TimeSpend
number
double - CanEdit
boolean
- CanCreateSubtask
boolean
- CanCreateTimeSpend
boolean
- CanDelete
boolean
- CanReadFiles
boolean
- Deadline
string
- StartDate
string
- MilestoneId
integer
int32 - Priority
enum of integer
int32 [0 - Normal, 1 - High, -1 - Low]
Can be one of:
Normal
,High
,Low
.- ProjectOwner
object
- Id
integer
int32 - Title
string
- Status
integer
int32 - IsPrivate
boolean
- Progress
integer
int32 - Subtasks
array of object
- CanEdit
boolean
- TaskId
integer
int32 - Created
string
- CreatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- CreatedById
string
uuid - Updated
string
- UpdatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- UpdatedById
string
uuid - Id
integer
int32 - Title
string
- Description
string
- Status
integer
int32 - Responsible
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- ResponsibleId
string
uuid
- Links
array of object
- DependenceTaskId
integer
int32 - ParentTaskId
integer
int32 - LinkType
enum of integer
int32 [0 - Start, 1 - End, 2 - EndStart]
Can be one of:
Start
,End
,EndStart
.
- Responsibles
array of object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- ResponsibleIds
array of string
- Milestone
object
- Id
integer
int32 - Title
string
- Deadline
string
- CustomTaskStatus
array of integer
- Created
string
- CreatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- CreatedById
string
uuid - Updated
string
- UpdatedBy
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- UpdatedById
string
uuid - Id
integer
int32 - Title
string
- Description
string
- Status
integer
int32 - Responsible
object
- Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
- ResponsibleId
string
uuid
401
Unauthorized