Orq.ai Documentation - AI Gateway & LLM Collaboration Platform

Retrieve a datapoint

curl --request GET \
  --url https://api.orq.ai/v2/datasets/{dataset_id}/datapoints/{datapoint_id} \
  --header 'Authorization: Bearer <token>'

{
  "_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-08T10:34:36.332Z"
    }
  ],
  "snapshot_version": "<string>",
  "created_by_id": "<string>",
  "updated_by_id": "<string>",
  "created": "2025-12-08T10:34:25.077Z",
  "updated": "2025-12-08T10:34:25.079Z"
}

GET

datasets

{dataset_id}

datapoints

{datapoint_id}

Retrieve a datapoint

curl --request GET \
  --url https://api.orq.ai/v2/datasets/{dataset_id}/datapoints/{datapoint_id} \
  --header 'Authorization: Bearer <token>'

{
  "_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-08T10:34:36.332Z"
    }
  ],
  "snapshot_version": "<string>",
  "created_by_id": "<string>",
  "updated_by_id": "<string>",
  "created": "2025-12-08T10:34:25.077Z",
  "updated": "2025-12-08T10:34:25.079Z"
}

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

datapoint_id

string

required

The unique identifier of the datapoint

Response

Datapoint retrieved.

_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.

Show child attributes

inputs.{key}

any

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.

System message
Developer message
User message
Assistant message
Tool message

Show child attributes

messages.role

enum<string>

required

The role of the messages author, in this case system.

Available options:

system

messages.content

required

The contents of the system message.

messages.name

string

An optional name for the participant. Provides the model information to differentiate between participants of the same role.

expected_output

string

evaluations

object[]

Evaluations associated with the datapoint

Option 1
Option 2
Option 3

Show child attributes

evaluations.id

string

required

The unique identifier of the human evaluation

evaluations.evaluation_type

enum<string>

required

The type of evaluation

Available options:

human_review

evaluations.human_review_id

string

required

The unique identifier of the human review

evaluations.reviewed_by_id

string

required

The unique identifier of the user who reviewed the item

evaluations.type

enum<string>

required

Available options:

string

evaluations.value

string

required

evaluations.source

enum<string>

default:orq

Available options:

orq,

external

evaluations.reviewed_at

string<date-time>

default:2025-12-08T10:34:36.332Z

The date and time the item was reviewed

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-08T10:34:25.077Z

The date and time the resource was created

updated

default:2025-12-08T10:34:25.079Z

The date and time the resource was last updated

Create a datapoint

Delete a datapoint

⌘I

Platform APIs

Gateway APIs

Retrieve a datapoint

Authorizations

Path Parameters

Response