Api Datasets List Update

PUT

https://api.respan.ai/api/datasets/list/

PUT

/api/datasets/list/

$ curl -X PUT https://api.respan.ai/api/datasets/list/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "string"
> }'

200Updated

1 {
2   "organization_id": 1,
3   "updated_by": {
4     "id": 1,
5     "email": "string",
6     "name": "string",
7     "username": "string",
8     "first_name": "string",
9     "last_name": "string"
10   },
11   "name": "string",
12   "created_at": "2024-01-15T09:30:00Z",
13   "updated_at": "2024-01-15T09:30:00Z",
14   "completed_annotation_count": 1,
15   "tags": [
16     {
17       "id": "string",
18       "name": "string",
19       "color": "string",
20       "created_at": "2024-01-15T09:30:00Z",
21       "updated_at": "2024-01-15T09:30:00Z"
22     }
23   ],
24   "granularity": "logs",
25   "id": "string",
26   "log_count": 1,
27   "log_ids": [
28     "string"
29   ],
30   "description": "string",
31   "type": "llm",
32   "status": "initializing",
33   "running_status": "draft",
34   "running_progress": 1.1,
35   "starred": true
36 }

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Request

This endpoint expects an object.

namestringRequired1-255 characters

idstringOptional1-255 characters

log_countintegerOptional0-2147483647

log_idslist of stringsOptional

descriptionstringOptional

typeenumOptional

llm - Llm
human - Human
dataset - Dataset
sampling - Sampling
reference - Reference

statusenumOptional

initializing - Initializing
ready - Ready
failed - Failed
loading - Loading

running_statusenumOptional

draft - Draft
pending - Pending
paused - Paused
running - Running
waiting_for_annotations - Waiting For Annotations
completed - Completed
failed - Failed

running_progressdoubleOptional

starredbooleanOptional

Response

organization_idintegerRead-only

updated_byobject

namestring<=255 characters

created_atdatetimeRead-only

updated_atdatetimeRead-only

completed_annotation_countintegerRead-only

tagslist of objectsRead-only

granularityenum

Eval unit for this dataset: ‘logs’ (one span per row) or ‘traces’ (one root row per trace). Chosen at creation and immutable.

logs - Logs
traces - Traces
threads - Threads

idstring<=255 characters

log_countinteger0-2147483647

log_idslist of strings

descriptionstring

typeenum

llm - Llm
human - Human
dataset - Dataset
sampling - Sampling
reference - Reference

statusenum

initializing - Initializing
ready - Ready
failed - Failed
loading - Loading

running_statusenum

draft - Draft
pending - Pending
paused - Paused
running - Running
waiting_for_annotations - Waiting For Annotations
completed - Completed
failed - Failed

running_progressdouble

starredboolean