Open a training

Attention

The toloka.yandex.com domain will be disabled starting July 1, 2023. Please use the toloka.dev domain for API requests.

Opens a training pool.

Training tasks will be available to Tolokers only if a training pool is open.

An operation is created when you send a request. To track the progress of the operation, send a request to the /operations resource.

Request

Tip

Try our new API reference: more parameter details, request/response examples, and code samples in various programming languages, including the Toloka-Kit usage samples.

Production version

Sandbox

POST https://toloka.dev/api/v1/trainings/<training_id>/open
Authorization: OAuth <OAuth token>

Path parameters

Parameter	Overview
training_id	Pool ID.

Headers

Title	Overview
Authorization	A token for account authorization. Add OAuth as a prefix.

Response

Note

If the current training pool status is the same as the requested status, an empty response with status 204 is returned.

{
  "id": "52829015-033f-4c3a-a7cc-0d7eff235663",
  "type": "TRAINING.OPEN",
  "status": "SUCCESS",
  "submitted": "2021-02-26T10:13:32.921",
  "started": "2021-02-26T10:13:32.921",
  "finished": "2021-02-26T10:13:32.921",
  "progress": 100,
  "parameters": {
    "training_id": "123456"
  },
  "details": {}
}

Parameter	Overview
id	string Operation ID.
type	string Type of operation: `TRAINING.OPEN` — Open a training pool.
status	string The status of the operation: `PENDING` — Not started yet. `RUNNING` — In progress. `SUCCESS` — Completed successfully. `FAIL` — Not completed.
submitted	string The UTC date and time the request was sent, in ISO 8601 format: `YYYY-MM-DDThh:mm:ss[.sss]`.
started	string The UTC date and time the operation started, in ISO 8601 format: `YYYY-MM-DDThh:mm:ss[.sss]`.
finished	string The UTC date and time the operation was completed, in ISO 8601 format: `YYYY-MM-DDThh:mm:ss[.sss]`.
progress	integer The percentage of the operation completed.
parameters.training_id	string ID of the training pool.
details	object Details of the operation completion.