Optional
configuration: ConfigurationThe new task will not have any attached images or videos. To attach them, use the /api/tasks/
Optional
xOrganization: stringOrganization unique slug
Optional
org: stringOrganization unique slug
Optional
orgId: numberOrganization identifier
Optional
options: RawAxiosRequestConfigOverride http request option.
The request POST /api/tasks/id/annotations initiates a background process to import annotations into a task. Please, use the GET /api/requests/<rq_id> endpoint for checking status of the process. The rq_id
parameter can be found in the response on initiating request.
A unique integer value identifying this task.
Optional
cloudStorageId: numberStorage id
Optional
filename: stringAnnotation file name
Optional
format: stringInput format name You can get the list of supported formats at: /server/annotation/formats
Optional
location: TasksCreateAnnotationsLocationEnumwhere to import the annotation from
Optional
useDefaultLocation: booleanUse the location that was configured in task to import annotations
Optional
taskAnnotationsWriteRequest: null | AnnotationFileRequestOptional
options: RawAxiosRequestConfigOverride http request option.
The backup import process is as follows: The first request POST /api/tasks/backup will initiate file upload and will create the rq job on the server in which the process of a task creating from an uploaded backup will be carried out. After initiating the backup upload, you will receive an rq_id parameter. Make sure to include this parameter as a query parameter in your subsequent requests to track the status of the task creation. Once the task has been successfully created, the server will return the id of the newly created task.
Optional
xOrganization: stringOrganization unique slug
Optional
cloudStorageId: numberStorage id
Optional
filename: stringBackup file name
Optional
location: TasksCreateBackupLocationEnumWhere to import the backup file from
Optional
org: stringOrganization unique slug
Optional
orgId: numberOrganization identifier
Optional
rqId: stringrq id
Optional
taskFileRequest: TaskFileRequestOptional
options: RawAxiosRequestConfigOverride http request option.
The request POST /api/<projects|tasks>/id/backup/export
will initialize a background process to backup a resource. To check status of the process please, use GET /api/requests/<rq_id>
where rq_id is request ID returned in the response for this endpoint.
A unique integer value identifying this task.
Optional
cloudStorageId: numberStorage id
Optional
filename: stringBackup file name
Optional
location: TasksCreateBackupExportLocationEnumWhere need to save downloaded backup
Optional
options: RawAxiosRequestConfigOverride http request option.
Allows to upload data (images, video, etc.) to a task. Supports the TUS open file uploading protocol (https://tus.io/). Supports the following protocols: 1. A single Data request and 2.1. An Upload-Start request 2.2.a. Regular TUS protocol requests (Upload-Length + Chunks) 2.2.b. Upload-Multiple requests 2.3. An Upload-Finish request Requests: - Data - POST, no extra headers or 'Upload-Start' + 'Upload-Finish' headers. Contains data in the body. - Upload-Start - POST, has an 'Upload-Start' header. No body is expected. - Upload-Length - POST, has an 'Upload-Length' header (see the TUS specification) - Chunk - HEAD/PATCH (see the TUS specification). Sent to /data/GET /api/requests/<rq_id>
, where rq_id is request ID returned for this request. Once data is attached to a task, it cannot be detached or replaced.
A unique integer value identifying this task.
Optional
uploadFinish: booleanFinishes data upload. Can be combined with Upload-Start header to create task data with one request
Optional
uploadMultiple: booleanIndicates that data with this request are single or multiple files that should be attached to a task
Optional
uploadStart: booleanInitializes data upload. Optionally, can include upload metadata in the request body.
Optional
dataRequest: DataRequestOptional
options: RawAxiosRequestConfigOverride http request option.
The request POST /api/<projects|tasks|jobs>/id/dataset/export
will initialize a background process to export a dataset. To check status of the process please, use GET /api/requests/<rq_id>
where rq_id is request ID returned in the response for this endpoint.
Desired output format name You can get the list of supported formats at: /server/annotation/formats
A unique integer value identifying this task.
Optional
cloudStorageId: numberStorage id
Optional
filename: stringDesired output file name
Optional
location: TasksCreateDatasetExportLocationEnumWhere need to save downloaded dataset
Optional
saveImages: booleanInclude images or not
Optional
options: RawAxiosRequestConfigOverride http request option.
Optional
xOrganization: stringOrganization unique slug
Optional
assignee: stringA simple equality filter for the assignee field
Optional
dimension: TasksListDimensionEnumA simple equality filter for the dimension field
Optional
filter: stringJSON Logic filter. This filter can be used to perform complex filtering by grouping rules. For example, using such a filter you can get all resources created by you: - {"and":[{"==":[{"var":"owner"},"<user>"]}]} Details about the syntax used can be found at the link: https://jsonlogic.com/ Available filter_fields: ['project_name', 'name', 'owner', 'status', 'assignee', 'subset', 'mode', 'dimension', 'tracker_link', 'validation_mode', 'id', 'project_id', 'updated_date']. There are few examples for complex filtering tasks: - Get all tasks from 1,2,3 projects - { "and" : [{ "in" : [{ "var" : "project_id" }, [1, 2, 3]]}]} - Get all completed tasks from 1 project - { "and": [{ "==": [{ "var" : "status" }, "completed"]}, { "==" : [{ "var" : "project_id"}, 1]}]}
Optional
mode: stringA simple equality filter for the mode field
Optional
name: stringA simple equality filter for the name field
Optional
org: stringOrganization unique slug
Optional
orgId: numberOrganization identifier
Optional
owner: stringA simple equality filter for the owner field
Optional
page: numberA page number within the paginated result set.
Optional
pageSize: numberNumber of results to return per page.
Optional
projectId: numberA simple equality filter for the project_id field
Optional
projectName: stringA simple equality filter for the project_name field
Optional
search: stringA search term. Available search_fields: ('project_name', 'name', 'owner', 'status', 'assignee', 'subset', 'mode', 'dimension', 'tracker_link', 'validation_mode')
Optional
sort: stringWhich field to use when ordering the results. Available ordering_fields: ['project_name', 'name', 'owner', 'status', 'assignee', 'subset', 'mode', 'dimension', 'tracker_link', 'validation_mode', 'id', 'project_id', 'updated_date']
Optional
status: TasksListStatusEnumA simple equality filter for the status field
Optional
subset: stringA simple equality filter for the subset field
Optional
trackerLink: stringA simple equality filter for the tracker_link field
Optional
validationMode: TasksListValidationModeEnumA simple equality filter for the validation_mode field
Optional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
patchedTaskWriteRequest: PatchedTaskWriteRequestOptional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
patchedLabeledDataRequest: PatchedLabeledDataRequestOptional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
patchedDataMetaWriteRequest: PatchedDataMetaWriteRequestOptional
options: RawAxiosRequestConfigOverride http request option.
WARNING: this operation is not protected from race conditions. It's up to the user to ensure no parallel calls to this operation happen. It affects image access, including exports with images, backups, chunk downloading etc.
A unique integer value identifying this task.
Optional
patchedTaskValidationLayoutWriteRequest: PatchedTaskValidationLayoutWriteRequestOptional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
options: RawAxiosRequestConfigOverride http request option.
Deprecation warning: Utilizing this endpoint ot export annotations as a dataset in a specific format will be deprecated in one of the next releases. Consider using new API: - POST /api/tasks/<task_id>/dataset/export?save_images=False to initiate export process - GET /api/requests/<rq_id> to check process status, where rq_id is request id returned on initializing request
A unique integer value identifying this task.
Optional
action: "download"Used to start downloading process locally after annotation file has been created
Optional
cloudStorageId: numberStorage id
Optional
filename: stringDesired output file name
Optional
format: stringDesired output format name You can get the list of supported formats at: /server/annotation/formats
Optional
location: TasksRetrieveAnnotationsLocationEnumWhere need to save downloaded dataset
Optional
useDefaultLocation: booleanUse the location that was configured in the task to export annotation
Optional
options: RawAxiosRequestConfigOverride http request option.
Deprecation warning: This endpoint will be deprecated in one of the next releases. Consider using new API: - POST /api/tasks/<task_id>/backup/export to initiate backup process - GET /api/requests/<rq_id> to check process status, where rq_id is request id returned on initializing request'
A unique integer value identifying this task.
Optional
action: "download"Used to start downloading process after backup file had been created
Optional
cloudStorageId: numberStorage id
Optional
filename: stringBackup file name
Optional
location: TasksRetrieveBackupLocationEnumWhere need to save downloaded backup
Optional
useDefaultLocation: booleanUse the location that was configured in the task to export backup
Optional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
number: numberA unique number value identifying chunk or frame
Optional
quality: TasksRetrieveDataQualityEnumSpecifies the quality level of the requested data
Optional
type: TasksRetrieveDataTypeEnumSpecifies the type of the requested data
Optional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
options: RawAxiosRequestConfigOverride http request option.
Deprecation warning: Utilizing this endpoint to export task dataset in a specific format will be deprecated in one of the next releases. Consider using new API: - POST /api/tasks/<task_id>/dataset/export?save_images=True to initiate export process - GET /api/requests/<rq_id> to check process status, where rq_id is request id returned on initializing request
Desired output format name You can get the list of supported formats at: /server/annotation/formats
A unique integer value identifying this task.
Optional
action: "download"Used to start downloading process locally after annotation file has been created
Optional
cloudStorageId: numberStorage id
Optional
filename: stringDesired output file name
Optional
location: TasksRetrieveDatasetLocationEnumWhere need to save downloaded dataset
Optional
useDefaultLocation: booleanUse the location that was configured in task to export annotations
Optional
options: RawAxiosRequestConfigOverride http request option.
This method is deprecated and will be removed in one of the next releases. To check status of task creation, use new common API for managing background operations: GET /api/requests/?action=create&task_id=<task_id>
A unique integer value identifying this task.
Optional
options: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optional
options: RawAxiosRequestConfigOverride http request option.
Utilizing this endpoint to check status of the import process is deprecated in favor of the new requests API: GET /api/requests/<rq_id>, where rq_id
parameter is returned in the response on initializing request.
A unique integer value identifying this task.
Optional
format: stringInput format name You can get the list of supported formats at: /server/annotation/formats
Optional
rqId: stringrq id
Optional
taskAnnotationsUpdateRequest: null | TaskAnnotationsUpdateRequestOptional
options: RawAxiosRequestConfigOverride http request option.
TasksApi - functional programming interface
Export