Get a dataset by ID

GET/api/v1/datasets/{dataset_id}

Get a dataset by ID

Path ParametersExpand Collapse

dataset_id: string

ReturnsExpand Collapse

Dataset = object { configured_column_mapping, created_at, dataset_id, 9 more }

configured_column_mapping: object { chat, completion, context, 2 more }

User-configured column mapping. Null if not yet configured.

chat: string

completion: string

context: array of string

image: string

prompt: string

created_at: string

Timestamp when the dataset was created

formatdate-time

dataset_id: string

Unique dataset identifier

error_data: object { code, level, message }

Error details if the dataset failed. Null otherwise.

code: string

Stable error code when the failure was structured (e.g. E0100)

level: "error" or "warning"

Severity when known

One of the following:

"error"

"warning"

message: string

Error message

evaluation_summary: object { grade_after, grade_before, improvement_percent, 2 more }

Compact evaluation summary. Null if evaluation has not completed.

grade_after: string

Letter grade (A-E) after augmentation

grade_before: string

Letter grade (A-E) before augmentation

improvement_percent: number

Relative improvement percentage

score_after: number

Quality score after augmentation

score_before: number

Quality score before augmentation

image_column_formats: map["embedded_bytes" or "url" or "file_reference"]

Per-column export encoding for detected image columns (column name → format). Use with GET /datasets/{dataset_id}/download: look up the active image column (mapped image column that is also in configured_column_mapping.context) to determine how each row's original_image is encoded. Null or empty when no image columns were detected.

One of the following:

"embedded_bytes"

"url"

"file_reference"

name: string

Human-readable name for the dataset

progress: object { percent, processed_rows, total_rows }

Processing progress. Null when no run is active.

percent: number

Progress percentage (0-100)

processed_rows: number

Number of rows processed so far

total_rows: number

Total rows to process (samples_to_process or row_count)

row_count: number

Total number of rows in the dataset

run_id: string

ID of the currently active run

status: "pending" or "running" or "succeeded" or "failed"

Lifecycle status: pending, running, succeeded, or failed

One of the following:

"pending"

"running"

"succeeded"

"failed"

updated_at: string

Timestamp of the last update

formatdate-time

Get a dataset by ID

curl https://api.prod.adaptionlabs.ai/api/v1/datasets/$DATASET_ID \
    -H "Authorization: Bearer $ADAPTION_API_KEY"

{
  "configured_column_mapping": {
    "chat": "chat",
    "completion": "completion",
    "context": [
      "string"
    ],
    "image": "image",
    "prompt": "prompt"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "dataset_id": "dataset_id",
  "error_data": {
    "code": "code",
    "level": "error",
    "message": "message"
  },
  "evaluation_summary": {
    "grade_after": "grade_after",
    "grade_before": "grade_before",
    "improvement_percent": 0,
    "score_after": 0,
    "score_before": 0
  },
  "image_column_formats": {
    "foo": "embedded_bytes"
  },
  "name": "name",
  "progress": {
    "percent": 0,
    "processed_rows": 0,
    "total_rows": 0
  },
  "row_count": 0,
  "run_id": "run_id",
  "status": "pending",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

{
  "configured_column_mapping": {
    "chat": "chat",
    "completion": "completion",
    "context": [
      "string"
    ],
    "image": "image",
    "prompt": "prompt"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "dataset_id": "dataset_id",
  "error_data": {
    "code": "code",
    "level": "error",
    "message": "message"
  },
  "evaluation_summary": {
    "grade_after": "grade_after",
    "grade_before": "grade_before",
    "improvement_percent": 0,
    "score_after": 0,
    "score_before": 0
  },
  "image_column_formats": {
    "foo": "embedded_bytes"
  },
  "name": "name",
  "progress": {
    "percent": 0,
    "processed_rows": 0,
    "total_rows": 0
  },
  "row_count": 0,
  "run_id": "run_id",
  "status": "pending",
  "updated_at": "2019-12-27T18:11:19.117Z"
}