Querying the Team Labeling Task List by a Team Member

Function

This API is used to query the team labeling task list by a team member.

Debugging

You can debug this API through automatic authentication in or use the SDK sample code generated by API Explorer.

URI

GET /v2/{project_id}/workforces/worker-tasks

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain a project ID, see Obtaining a Project ID and Name.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is 10.

offset

No

Integer

Start page of the paging list. The default value is 0.

order

No

String

Sorting method. Options:

  • asc: ascending order

  • desc: descending order (default value)

search_content

No

String

Fuzzy search keyword. By default, this parameter is left blank.

sort_by

No

String

Sorting mode of the query. Options:

  • create_time: Sort by creation time. (Default value)

  • workforce_task_name: Sort by task name.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

count

Integer

Total number of team labeling tasks.

worker_tasks

Array of WorkerTask objects

Team labeling task list queried by page.

Table 4 WorkerTask

Parameter

Type

Description

create_time

Long

Time when a labeling team member's task is created.

dataset_id

String

ID of a dataset associated with a labeling team member's task.

dataset_type

Integer

Labeling type of a team member's task.

email

String

Email address of a labeling team member.

email_status

Integer

Email notification status of a labeling team member's labeling task. Options:

  • 0: The email has not been sent.

  • 1: The email format is incorrect.

  • 2: The email address is unreachable.

  • 3: The email has been sent.

last_notify_time

Long

Timestamp of the latest notification email sent to a labeling team member.

pass_rate

Double

Pass rate of task acceptance review for a labeling team member.

role

Integer

Role of a labeling team member.

sample_stats

SampleStats object

Sample statistics of a labeling team member's task.

score

Double

Average acceptance score of labeling team members' task samples.

task_id

String

Team labeling task ID associated with a member's task.

task_status

Integer

Task status of a labeling team member. Options:

  • 6: created

  • 0: starting

  • 1: running

  • 2: under acceptance

  • 3: approved, indicating the team labeling task is complete

  • 4: rejected, indicating that the task needs to be labeled and reviewed again

update_time

Long

Time when a labeling team member's task is updated.

worker_id

String

ID of a labeling team member.

workforce_task_name

String

Team labeling task name associated with a member's task.

Table 5 SampleStats

Parameter

Type

Description

accepted_sample_count

Integer

Number of samples accepted by the owner.

auto_annotation_sample_count

Integer

Number of samples to be confirmed after intelligent labeling.

deleted_sample_count

Integer

Number of deleted samples.

rejected_sample_count

Integer

Number of samples that failed to pass the owner acceptance.

sampled_sample_count

Integer

Number of samples that are to be accepted by the owner and sampled.

total_sample_count

Integer

Total number of samples.

unannotated_sample_count

Integer

Number of unlabeled samples.

uncheck_sample_count

Integer

Number of samples that have been approved by the reviewer and are to be accepted by the owner.

unreviewed_sample_count

Integer

Number of samples that have been labeled by the labeler but have not been reviewed by the reviewer.

Example Requests

Querying the Team Labeling Task List by a Team Member

GET https://{endpoint}/v2/{project_id}/workforces/worker-tasks?offset=0&limit=10&sort_by=create_time&order=desc&filePreview=false

Example Responses

Status code: 200

OK

{
  "count" : 2,
  "worker_tasks" : [ {
    "email" : "xxx@xxx.com",
    "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
    "role" : 0,
    "task_id" : "tY330MHxV9dqIPVaTRM",
    "workforce_task_name" : "task-cd60",
    "dataset_id" : "WxCREuCkBSAlQr9xrde",
    "sample_stats" : {
      "total_sample_count" : 309,
      "unannotated_sample_count" : 308,
      "unreviewed_sample_count" : 0,
      "uncheck_sample_count" : 1,
      "sampled_sample_count" : 0,
      "rejected_sample_count" : 0,
      "accepted_sample_count" : 0,
      "auto_annotation_sample_count" : 0
    },
    "create_time" : 1606224714358,
    "update_time" : 1606224878490,
    "email_status" : 3,
    "last_notify_time" : 0,
    "dataset_type" : 1,
    "task_status" : 1
  }, {
    "email" : "xxx@xxx.com",
    "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
    "role" : 0,
    "task_id" : "MJVjCQDMso95a8dvUm4",
    "workforce_task_name" : "task-2720",
    "dataset_id" : "OY82gjEHxt9w1efgrhS",
    "sample_stats" : {
      "total_sample_count" : 50005,
      "unannotated_sample_count" : 50005,
      "unreviewed_sample_count" : 0,
      "uncheck_sample_count" : 0,
      "sampled_sample_count" : 0,
      "rejected_sample_count" : 0,
      "accepted_sample_count" : 0,
      "auto_annotation_sample_count" : 0
    },
    "create_time" : 1605949737134,
    "update_time" : 1605949737134,
    "email_status" : 3,
    "last_notify_time" : 0,
    "dataset_type" : 0,
    "task_status" : 2
  } ]
}

Status Codes

Status Code

Description

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.