Function

This API is used to start a team labeling task.

URI

POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
dataset_id	Yes	String	Dataset ID.
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
workforce_task_id	Yes	String	ID of a team labeling task.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
dataset_id	No	String	Dataset ID.
task_id	No	String	ID of a team labeling task.
workforces_config	No	WorkforcesConfig object	Team labeling task information: Tasks can be assigned by the team administrator or a specified team.

**Table 3** WorkforcesConfig
Parameter	Mandatory	Type	Description
agency	No	String	Team administrator.
workforces	No	Array of WorkforceConfig objects	List of teams that execute labeling tasks.

**Table 4** WorkforceConfig
Parameter	Mandatory	Type	Description
workers	No	Array of Worker objects	List of labeling team members.
workforce_id	No	String	ID of a labeling team.
workforce_name	No	String	Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"'

**Table 5** Worker
Parameter	Mandatory	Type	Description
create_time	No	Long	Creation time.
description	No	String	Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"'
email	No	String	Email address of a labeling team member.
role	No	Integer	Role. The options are as follows: 0: labeling personnel 1: reviewer 2: team administrator 3: dataset owner
status	No	Integer	Current login status of a labeling team member. The options are as follows: 0: The invitation email has not been sent. 1: The invitation email has been sent but the user has not logged in. 2: The user has logged in. 3: The labeling team member has been deleted.
update_time	No	Long	Update time.
worker_id	No	String	ID of a labeling team member.
workforce_id	No	String	ID of a labeling team.

Response Parameters

None

Example Requests

Starting a Team Labeling Task

{
  "workforces_config" : {
    "workforces" : [ {
      "workforce_id" : "l4u9Hpz2JJ67DNN1Hg9",
      "workers" : [ {
        "email" : "xiaozhang@163.com"
      }, {
        "email" : "xiaoli@163.com"
      } ]
    } ]
  }
}

Example Responses

Status code: 200

OK

{ }

Status Codes

Status Code	Description
200	OK
401	Unauthorized
403	Forbidden
404	Not Found

Error Codes

See Error Codes.