Upload a file for a new labeling session
A file contains one or more documents that can be used to create a labeling session.If show_preview is True, a preview will be shown and the endpoint to createa new labeling session must be called using the "id" and a column nameobtained in the preview response.
Path Parameters
- project_id integer required
ID of the project
- multipart/form-data
Request Body required
- show_preview boolean
If true, a preview will be shown.
- file binary required
file to upload
- 200
- 400
- 401
- 403
- 404
- 409
- 500
The File has been uploaded.
- application/json
- Schema
- Example (from schema)
Schema
- created date-time
When the session was started.
- finished date-time
When the session was finished.
- document_count integer
Total of documents
- document_group_id integer
ID of the document group related to the session, if any
- organization_id integer
ID of the organization to which the session belongs.
- user_id integer
ID of the user to which the session belongs.
- project_id integer
ID of the project to which the session belongs.
- uuid uuid
The unique ID of the session.
- id integer
The ID of the session.
- name string
The session's name.
- progress float
The session's progress.
- model_id integer
The ID of the model used by that session. This property only makes sense for correction sessions
- status string
Possible values: [
CREATED
,STARTED
,ANNOTATING
,FAILED
,FINISHED
,SAMPLING
,PREDICTING
,DELETING
]The session's status.
- mode string
Possible values: [
ANNOTATION
,CORRECTION
]The session's mode.
- type string
Possible values: [
ABSA
,CLASS
,LABEL
,CLASSLABEL
]The session's classification type.
- description string
The session's description.
- classes string[]
All classes that belong to the session
- labels string[]
All labels that belong to the session
{
"created": "2023-11-02",
"finished": "2023-11-02",
"document_count": 100,
"document_group_id": 87,
"organization_id": 1,
"user_id": 1,
"project_id": 1,
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": 1,
"name": "This is my first labeling session",
"progress": 87.7,
"model_id": 10,
"status": "CREATED",
"mode": "ANNOTATION",
"type": "ABSA",
"description": "string",
"classes": [
"Comfort"
],
"labels": [
"POS"
]
}
The uploaded file has an invalid format or a non-supported extension.
User is not authenticated. This means token is either not present or invalid
User is read-only or does not have the minimal required project role "ANNOTATOR"
The project was not found
File has no valid documents
Something is wrong with the API.