{
  "task_id": "task_abc123",
  "project": "project_abc123",
  "batch": "batch_abc123",
  "status": "completed",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "threads": [
    ...omitted...
  ]
}
{
  "task_id": "task_abc123",
  "project": "project_abc123",
  "batch": "batch_abc123",
  "status": "pending",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "threads": [
    {
      "id": "thread_abc123",
      "turns": [
        {
          "id": "turn_abc123",
          "messages": [
            {
              "role": "system",
              "content": {
                "text": "<string>",
                "reference_texts": [
                  {
                    "content": "<string>",
                    "category": "<string>",
                    "url": "<string>"
                  }
                ],
                "attachments": [
                  {
                    "content": "aSDinaTvuI8gbWludGxpZnk=",
                    "mime_type": "text/plain",
                    "scale_url": "<string>",
                    "url": "<string>",
                    "name": "<string>"
                  }
                ],
                "chunks": [
                  {
                    "type": "<string>",
                    "annotations": [
                      {
                        "id": "an_abc123efg456",
                        "key": "formatting",
                        "type": "<string>",
                        "title": "Response Formatting",
                        "description": "Does the response contain issues with formatting?",
                        "labels": [
                          "Major Issues",
                          "Minor Issues",
                          "No Issues"
                        ],
                        "metadata": {
                          "criteria": "<any>"
                        },
                        "value": 3,
                        "possible_values": [
                          [
                            1,
                            2,
                            3
                          ]
                        ]
                      }
                    ],
                    "text": "<string>"
                  }
                ],
                "reasoning": [
                  {
                    "content": "<string>"
                  }
                ]
              },
              "source_id": "source_abc123",
              "model_parameters": {
                "model": "my-model-123",
                "temperature": 0.9,
                "max_completion_tokens": 1000,
                "top_p": 0.9,
                "top_k": 4
              },
              "annotations": [
                {
                  "id": "an_abc123efg456",
                  "key": "formatting",
                  "type": "<string>",
                  "title": "Response Formatting",
                  "description": "Does the response contain issues with formatting?",
                  "labels": [
                    "Major Issues",
                    "Minor Issues",
                    "No Issues"
                  ],
                  "metadata": {
                    "criteria": "<any>"
                  },
                  "value": 3,
                  "possible_values": [
                    [
                      1,
                      2,
                      3
                    ]
                  ]
                }
              ]
            }
          ],
          "annotations": [
            {
              "id": "an_abc123efg456",
              "key": "formatting",
              "type": "<string>",
              "title": "Response Formatting",
              "description": "Does the response contain issues with formatting?",
              "labels": [
                "Major Issues",
                "Minor Issues",
                "No Issues"
              ],
              "metadata": {
                "criteria": "<any>"
              },
              "value": 3,
              "possible_values": [
                [
                  1,
                  2,
                  3
                ]
              ]
            }
          ]
        }
      ],
      "annotations": [
        {
          "id": "an_abc123efg456",
          "key": "formatting",
          "type": "<string>",
          "title": "Response Formatting",
          "description": "Does the response contain issues with formatting?",
          "labels": [
            "Major Issues",
            "Minor Issues",
            "No Issues"
          ],
          "metadata": {
            "criteria": "<any>"
          },
          "value": 3,
          "possible_values": [
            [
              1,
              2,
              3
            ]
          ]
        }
      ]
    }
  ],
  "errors": [
    {
      "type": "UNSUPPORTED_LANGUAGE",
      "message": "The specified language or locale is not supported"
    }
  ],
  "sensitive_content_reports": [
    {
      "type": "violence",
      "message": "The prompt in the task promotes violence."
    }
  ]
}

The work to be done is defined in the Task parameters. For example, a single Task might ask a contributor to have a conversation with a chat model and label all of the responses from the model. These labels are called Annotations.

Scale API offers following endpoints to download tasks:

{
  "task_id": "task_abc123",
  "project": "project_abc123",
  "batch": "batch_abc123",
  "status": "completed",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "threads": [
    ...omitted...
  ]
}

The schema is of type object.