Starting a Team Labeling Task¶

Function¶

This API is used to start a team labeling task.

Debugging¶

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

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 a project ID, see Obtaining a Project ID and Name.
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	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. Options: 0: labeling personnel 1: reviewer 2: team administrator 3: dataset owner
status	No	Integer	Current login status of a labeling team member. Options: 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

{ }

Status Codes¶

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

Error Codes¶

See Error Codes.

last updated: 2024-11-14 08:44 UTC - commit: 3b80612feba1452e3d3adbec6770d8e1b5070820