Api Playgrounds Partial Update

PATCH

https://api.respan.ai/api/playgrounds/:playground_id/

PATCH

/api/playgrounds/:playground_id/

$ curl -X PATCH https://api.respan.ai/api/playgrounds/playground_id/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

1 {
2   "id": "string",
3   "name": "string",
4   "dataset_id": "string",
5   "created_by": {
6     "id": 1,
7     "email": "string",
8     "name": "string",
9     "username": "string",
10     "first_name": "string",
11     "last_name": "string"
12   },
13   "updated_by": {
14     "id": 1,
15     "email": "string",
16     "name": "string",
17     "username": "string",
18     "first_name": "string",
19     "last_name": "string"
20   },
21   "created_at": "2024-01-15T09:30:00Z",
22   "updated_at": "2024-01-15T09:30:00Z",
23   "tags": [
24     {
25       "id": "string",
26       "name": "string",
27       "color": "string",
28       "created_at": "2024-01-15T09:30:00Z",
29       "updated_at": "2024-01-15T09:30:00Z"
30     }
31   ],
32   "columns": [
33     {
34       "id": "string",
35       "name": "string",
36       "linked_prompt_id": "string",
37       "task_tracker_id": "string",
38       "run_status": "string",
39       "run_progress": "string",
40       "run_error_message": "string",
41       "created_at": "2024-01-15T09:30:00Z",
42       "updated_at": "2024-01-15T09:30:00Z",
43       "order": 1,
44       "column_type": "prompt",
45       "source_type": "prompt",
46       "linked_prompt_version": 1,
47       "experiment_id": "string",
48       "is_archived": true
49     }
50   ],
51   "description": "string",
52   "state_version": 1
53 }

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

playground_idstringRequired

Request

This endpoint expects an object.

namestringOptional1-255 characters

descriptionstring or nullOptional

Response

idstringRead-only

namestring<=255 characters

dataset_idstringRead-only

created_byobject

updated_byobject

created_atdatetimeRead-only

updated_atdatetimeRead-only

tagslist of objectsRead-only

columnslist of objectsRead-only

descriptionstring or null

state_versioninteger0-2147483647