Skip to main content
POST
/
v2
/
datasets
/
{dataset_id}
/
datapoints
Create a datapoint
curl --request POST \
  --url https://api.orq.ai/v2/datasets/{dataset_id}/datapoints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "inputs": {},
    "messages": [
      {
        "role": "system",
        "content": "<string>",
        "name": "<string>"
      }
    ],
    "expected_output": "<string>"
  }
]
'
[
  {
    "_id": "<string>",
    "workspace_id": "<string>",
    "dataset_id": "<string>",
    "inputs": {},
    "messages": [
      {
        "role": "system",
        "content": "<string>",
        "name": "<string>"
      }
    ],
    "expected_output": "<string>",
    "evaluations": [
      {
        "id": "<string>",
        "evaluation_type": "human_review",
        "human_review_id": "<string>",
        "reviewed_by_id": "<string>",
        "type": "string",
        "value": "<string>",
        "source": "orq",
        "reviewed_at": "2025-12-23T20:49:24.384Z"
      }
    ],
    "snapshot_version": "<string>",
    "created_by_id": "<string>",
    "updated_by_id": "<string>",
    "created": "2025-12-23T20:49:10.444Z",
    "updated": "2025-12-23T20:49:10.445Z"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
dataset_id
string
required

The unique identifier of the dataset

Body

application/json
Required array length: 1 - 5000 elements
​
inputs
object

The inputs of the dataset. Key value pairs where the key is the input name and the value is the input value. Nested objects are not supported.

​
messages
(System message · object | Developer message · object | User message · object | Assistant message · object | Tool message · object)[]

A list of messages comprising the conversation so far

Developer-provided instructions that the model should follow, regardless of messages sent by the user.

​
expected_output
string

Response

200 - application/json

Datapoints created successfully. Returns an array of newly created datapoint objects.

​
_id
string
required

The unique identifier of the dataset item

​
workspace_id
string
required

The unique identifier of the workspace it belongs to

​
dataset_id
string
required

The unique identifier of the dataset

​
inputs
object

The inputs of the dataset. Key value pairs where the key is the input name and the value is the input value. Nested objects are not supported.

​
messages
(System message · object | Developer message · object | User message · object | Assistant message · object | Tool message · object)[]

A list of messages comprising the conversation so far

Developer-provided instructions that the model should follow, regardless of messages sent by the user.

​
expected_output
string
​
evaluations
object[]

Evaluations associated with the datapoint

​
snapshot_version
string

The version of the dataset snapshot

​
created_by_id
string

The unique identifier of the user who created the dataset

​
updated_by_id
string

The unique identifier of the user who last updated the dataset

​
created
default:2025-12-23T20:49:10.444Z

The date and time the resource was created

​
updated
default:2025-12-23T20:49:10.445Z

The date and time the resource was last updated