Skip to main content
POST
Create annotation task

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
name
string
required

Task name, unique within your workspace

type
enum<string>
required

Task type. Determines the shape of each item's payload.

  • stt: judge a transcript on its own
  • llm: judge one response with its conversation history
  • llm-general: judge a standalone input -> output pair
  • conversation: judge a full conversation
Available options:
stt,
llm,
llm-general,
conversation,
tts
description
string | null

A description for the task. Omit for none

evaluator_ids
string[] | null

IDs of evaluators to link when the task is created, in order. Each must be one you created or a built-in default. Omit to create with no linked evaluators

Example:

Response

Successful Response

uuid
string
required

ID of the newly created task

Required string length: 36
Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

message
string
required

Confirmation that the task was created