Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Tasks

Get Task

Returns information about the specified task(s) by ID(s).

get/team-messaging/v1/tasks/{taskId}

Path parameters

taskIdstring required

Task identifier or comma separated list of task IDs

Response

OK

idstring

Internal identifier of a task

creationTimestring date-time

Task creation date/time in UTC time zone

lastModifiedTimestring date-time

Task the last modified time in UTC time zone

type'Task'

Task type

chatIdsstring[]

Internal identifiers of the chats where the task is posted or shared

status'Pending' | 'InProgress' | 'Completed'

Task execution status

subjectstring

Task name/subject

completenessCondition'Simple' | 'AllAssignees' | 'Percentage'

How the task completeness should be determined

completenessPercentageinteger

Current completeness percentage of the task with the specified percentage completeness condition

startDatestring date-time

Task start date

dueDatestring date-time

Task due date/time

color'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta'

Font color of a post with the current task

sectionstring

Task section to group / search by

descriptionstring

Task details