Optionalconfiguration: ConfigurationThe new task will not have any attached images or videos. To attach them, use the /api/tasks/
OptionalxOrganization: stringOrganization unique slug
Optionalorg: stringOrganization unique slug
OptionalorgId: numberOrganization identifier
Optionaloptions: 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.
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringAnnotation file name
Optionalformat: stringInput format name You can get the list of supported formats at: /server/annotation/formats
Optionallocation: TasksCreateAnnotationsLocationEnumwhere to import the annotation from
OptionaluseDefaultLocation: booleanUse the location that was configured in task to import annotations
OptionaltaskAnnotationsWriteRequest: null | AnnotationFileRequestOptionaloptions: 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.
OptionalxOrganization: stringOrganization unique slug
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringBackup file name
Optionallocation: TasksCreateBackupLocationEnumWhere to import the backup file from
Optionalorg: stringOrganization unique slug
OptionalorgId: numberOrganization identifier
OptionalrqId: stringrq id
OptionaltaskFileRequest: TaskFileRequestOptionaloptions: 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.
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringBackup file name
Optionallocation: TasksCreateBackupExportLocationEnumWhere need to save downloaded backup
Optionaloptions: 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.
OptionaluploadFinish: booleanFinishes data upload. Can be combined with Upload-Start header to create task data with one request
OptionaluploadMultiple: booleanIndicates that data with this request are single or multiple files that should be attached to a task
OptionaluploadStart: booleanInitializes data upload. Optionally, can include upload metadata in the request body.
OptionaldataRequest: DataRequestOptionaloptions: 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.
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringDesired output file name
Optionallocation: TasksCreateDatasetExportLocationEnumWhere need to save downloaded dataset
OptionalsaveImages: booleanInclude images or not
Optionaloptions: RawAxiosRequestConfigOverride http request option.
OptionalxOrganization: stringOrganization unique slug
Optionalassignee: stringA simple equality filter for the assignee field
Optionaldimension: TasksListDimensionEnumA simple equality filter for the dimension field
Optionalfilter: 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]}]}
Optionalmode: stringA simple equality filter for the mode field
Optionalname: stringA simple equality filter for the name field
Optionalorg: stringOrganization unique slug
OptionalorgId: numberOrganization identifier
Optionalowner: stringA simple equality filter for the owner field
Optionalpage: numberA page number within the paginated result set.
OptionalpageSize: numberNumber of results to return per page.
OptionalprojectId: numberA simple equality filter for the project_id field
OptionalprojectName: stringA simple equality filter for the project_name field
Optionalsearch: stringA search term. Available search_fields: ('project_name', 'name', 'owner', 'status', 'assignee', 'subset', 'mode', 'dimension', 'tracker_link', 'validation_mode')
Optionalsort: 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']
Optionalstatus: TasksListStatusEnumA simple equality filter for the status field
Optionalsubset: stringA simple equality filter for the subset field
OptionaltrackerLink: stringA simple equality filter for the tracker_link field
OptionalvalidationMode: TasksListValidationModeEnumA simple equality filter for the validation_mode field
Optionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
OptionalpatchedTaskWriteRequest: PatchedTaskWriteRequestOptionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
OptionalpatchedLabeledDataRequest: PatchedLabeledDataRequestOptionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
OptionalpatchedDataMetaWriteRequest: PatchedDataMetaWriteRequestOptionaloptions: 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.
OptionalpatchedTaskValidationLayoutWriteRequest: PatchedTaskValidationLayoutWriteRequestOptionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optionaloptions: 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.
Optionalaction: "download"Used to start downloading process locally after annotation file has been created
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringDesired output file name
Optionalformat: stringDesired output format name You can get the list of supported formats at: /server/annotation/formats
Optionallocation: TasksRetrieveAnnotationsLocationEnumWhere need to save downloaded dataset
OptionaluseDefaultLocation: booleanUse the location that was configured in the task to export annotation
Optionaloptions: 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.
Optionalaction: "download"Used to start downloading process after backup file had been created
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringBackup file name
Optionallocation: TasksRetrieveBackupLocationEnumWhere need to save downloaded backup
OptionaluseDefaultLocation: booleanUse the location that was configured in the task to export backup
Optionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optionalnumber: numberA unique number value identifying chunk or frame
Optionalquality: TasksRetrieveDataQualityEnumSpecifies the quality level of the requested data
Optionaltype: TasksRetrieveDataTypeEnumSpecifies the type of the requested data
Optionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optionaloptions: 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.
Optionalaction: "download"Used to start downloading process locally after annotation file has been created
OptionalcloudStorageId: numberStorage id
Optionalfilename: stringDesired output file name
Optionallocation: TasksRetrieveDatasetLocationEnumWhere need to save downloaded dataset
OptionaluseDefaultLocation: booleanUse the location that was configured in task to export annotations
Optionaloptions: 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.
Optionaloptions: RawAxiosRequestConfigOverride http request option.
A unique integer value identifying this task.
Optionaloptions: 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.
Optionalformat: stringInput format name You can get the list of supported formats at: /server/annotation/formats
OptionalrqId: stringrq id
OptionaltaskAnnotationsUpdateRequest: null | TaskAnnotationsUpdateRequestOptionaloptions: RawAxiosRequestConfigOverride http request option.
TasksApi - functional programming interface
Export