Api Annotation Items Retrieve

GET

https://api.respan.ai/api/annotation-items/:id/

GET

/api/annotation-items/:id/

$ curl https://api.respan.ai/api/annotation-items/id/ \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "id": "string",
3   "assignee": {
4     "id": 1,
5     "email": "string",
6     "name": "string",
7     "username": "string",
8     "first_name": "string",
9     "last_name": "string"
10   },
11   "created_by": {
12     "id": 1,
13     "email": "string",
14     "name": "string",
15     "username": "string",
16     "first_name": "string",
17     "last_name": "string"
18   },
19   "source_id": "string",
20   "source_type": "logs",
21   "source_dataset_id": "string",
22   "evaluator_ids": [
23     "string"
24   ],
25   "full_object": null,
26   "created_at": "2024-01-15T09:30:00Z",
27   "updated_at": "2024-01-15T09:30:00Z",
28   "organization": 1,
29   "project": "string",
30   "status": "pending",
31   "completed_at": "2024-01-15T09:30:00Z"
32 }

GET/PATCH/DELETE /api/annotation-items/{id}/

Retrieve, update, or delete a specific annotation item (RUD from CRUD).

Permission (via ObjectOwnershipMixin config in SuperAdminMixin):

Worker (assignee): Can GET/PATCH their OWN assigned items (status only)
Org Admin: Can GET/PATCH/DELETE any item in org (can re-assign)
Superadmin: Can access all items across all orgs

GET: Returns full item details with all fields PATCH:

Worker: Update status, completed_at
Admin: Also update assignee_id (re-assign) DELETE: Delete item (admin only via ownership check)

GET/PATCH/DELETE /api/annotation-items/{id}/ Retrieve, update, or delete a specific annotation item (RUD from CRUD). Permission (via ObjectOwnershipMixin config in SuperAdminMixin): - Worker (assignee): Can GET/PATCH their OWN assigned items (status only) - Org Admin: Can GET/PATCH/DELETE any item in org (can re-assign) - Superadmin: Can access all items across all orgs GET: Returns full item details with all fields PATCH: - Worker: Update status, completed_at - Admin: Also update assignee_id (re-assign) DELETE: Delete item (admin only via ownership check)

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

idstringRequired

Response

idstringRead-only

assigneeobject

created_byobject

source_idstringRead-only

source_typeenum

logs - Logs
dataset_logs - Dataset Logs
threads - Threads

source_dataset_idstring or nullRead-only

evaluator_idslist of stringsRead-only

List of evaluator IDs that define which scoring criteria the assignee should fill out

full_objectanyRead-only

created_atdatetimeRead-only

updated_atdatetimeRead-only

organizationintegerRead-only

projectstring or null

statusenum

pending - Pending
processing - Processing
paused - Paused
completed - Completed
failed - Failed
cancelled - Cancelled

completed_atdatetime or null