Skip to main content

Labelling API (1.0)

Download OpenAPI specification:Download

home

api.index.hello_world

Check API status and version

Authorizations:
ApiSecurity

Responses

login

api.auth.get

Check user login status

Authorizations:
ApiSecurity

Responses

api.auth.get_permissions

Get user permissions

Authorizations:
ApiSecurity

Responses

api.auth.create_api_token

Generate unique long lived API token that can be used to login as current user in machine 2 machine scenarios

Authorizations:
ApiSecurity

Responses

api.auth.get_auth_url_params

Endpoint to request temporary valid parameter for URL that can not be authenticated via headers. Used for download of big files.

Authorizations:
ApiSecurity
query Parameters
project_id
required
string

id of project

parameter
required
string

parameter of the next auth request

Responses

api.google_oauth_flow.get_auth_url

Request for google authentication for scenarious where google token needs to be saved on server (BigQuery integration)

Authorizations:
ApiSecurity
query Parameters
final_redirect
required
string

where to next

project_id
string

id of project to authenicate for

reprocess
string

where to next

Responses

api.google_oauth_flow.oauth2callback

Callback for google authentication for scenarious where google token needs to be saved on server (BigQuery integration)

Authorizations:
ApiSecurity

Responses

projects

api.projects.get

Get full project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.projects.delete

Delete project and its data permanently

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.projects.search

Search for project

Authorizations:
ApiSecurity
query Parameters
name
string

name of project or it's part

exact_match
boolean

wheter to request only exact match

Responses

api.projects.post

Upsert project

Authorizations:
ApiSecurity
query Parameters
download_and_process_data
boolean

if project data should be downloaded from source and processed

merge_with_new_data
boolean
Request Body schema: application/json

project data

id
string
name
string

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "name": "string"
}

api.projects.get_status

Get Project info and statistics

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.projects.get_info

Get Project info, statistics, and label settings

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.projects.apply_labels_from_project

Copy labels from one project to another (match by key)

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
source_project_id
required
string

id of project

missing_label_behaviour
required
string

one of none | skip | add_to_project

Responses

api.projects.files_upload

Upload files to project

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
download_and_process_data
boolean

if project data should be downloaded from source and processed

Responses

api.projects.download_file

export project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

file_name
required
string

id of project

query Parameters
token_hash
required
string

token_hash

til
required
string

til

Responses

api.projects.schedule_project_export

export project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.projects.upload_files

import project data

Authorizations:
ApiSecurity
query Parameters
gcp_upload_url
string

id of project

Responses

api.projects.project_import

import project data

Authorizations:
ApiSecurity
query Parameters
into_project_id
string

id of project

file_url
string

url of the file to process

Responses

api.projects.get_project_import_upload_url

get import project data upload url

Authorizations:
ApiSecurity

Responses

api.projects.add_new_label

Create new label definition in project

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
label
string

Responses

Request samples

Content type
application/json
{
  • "label": "string"
}

api.projects.patch_preferences

Update general lebeling settings for project like similarity threshold

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json

object like {"similarity_threshold":0.8}

object

Responses

Request samples

Content type
application/json
{ }

api.projects.add_keyword_to_label

Add keyword to projekt label

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

models

api.models.get_custom_models

Get project models

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

Responses

api.models.model_info

Authorizations:
ApiSecurity
path Parameters
project_name
required
string
model_name
required
string

Responses

api.models.download_model

export project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

model_id
required
string

model_name or id

query Parameters
token_hash
required
string

token_hash

til
required
string

til

file_name
string

name

Responses

api.models.get_download_model_urls

export model - retrieva temp download URL

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
model_name_or_id
required
string

id or naame of model

Responses

api.models.get_model_import_upload_url

get upload url

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
task_type
required
string

model task type

model_name
required
string

model name (without project name)

Responses

api.models.create_model_from_upload

get upload url

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
temp_file_path
required
string

path of files in GPC, retrieved from projects/{project_id}/models/upload/get_url endpoint

task_type
required
string

model task type

model_name
required
string

model name (without project name)

Responses

api.models.upload_files

upload project

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

query Parameters
gcp_upload_url
string

id of project

Responses

api.projects.get_predictions_info

import project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

id of project

Responses

api.models.train_new

Train model

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json

training parameters

max_num_epochs
number
from_model
string

Responses

Request samples

Content type
application/json
{
  • "max_num_epochs": 0,
  • "from_model": "string"
}

api.models.get_train_options

Get default training options

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
task_type
string

Responses

api.models.get

get model information

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
model_id
required
string

Responses

api.models.delete

delete model

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
model_id
required
string

Responses

api.models.apply_predict

apply prediction of a model on project data

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
model_id
required
string

Responses

api.models.compare_predictions

apply alternative predition of a model on project data and compare it

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
model_id
required
string

Responses

api.models.apply_embeddings

re-create document embeddings and reindex data with them

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
model_id
required
string

Responses

tasks

api.tasks.get

get active and past tasks (shown in sidebar) for project or globaly for tennant

Authorizations:
ApiSecurity
query Parameters
project_id
string

id of the projekct

Responses

api.tasks.get_task_status

get status of a task

Authorizations:
ApiSecurity
path Parameters
task_id
required
string

task_id

Responses

api.tasks.hide

hide task info

Authorizations:
ApiSecurity
path Parameters
task_id
required
string

task_id to hide

Responses

api.tasks.get_results_data

Authorizations:
ApiSecurity
path Parameters
task_id
required
string

task_id

Responses

topics

api.topics.get

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
topic_id
required
number

Responses

api.topics.patch

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
topic_id
required
number
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.topics.regenerate

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

Responses

api.topics.stats

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
topic_id
required
number

Responses

api.topics.search

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
keyword
string
skip
integer
Default: 0

number of documents to skip in result before fetching

take
integer
Default: 50

max number of documents to load

Responses

documents

api.docs.add_documents

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
upsert
boolean

wheter if duplicate key is already in database, it should be overriden... default false

Request Body schema: application/json
Array
object

Responses

Request samples

Content type
application/json
[
  • { }
]

api.docs.get

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string

Responses

api.docs.delete

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string

Responses

api.docs.exclude

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

api.docs.export_vectors

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

api.docs.get_count

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
topic_id
string

filter for find only the docs for topic

keyword
string

keyword to find in all text documents

by_label
string

filtering by label ... special values - 'null' / '!null' for filtering with any or none label

key
string

key of document

false_positives
string

label to search for in falsly positive predicted labels on documents

false_negatives
string

label to search for in falsly negagtive predicted labels on documents

predicted_label
string

label that was predicted on document

prediction_certainty
string

preduction certainty of predicted_label (if number is negative, it's certainty of not predition that label)

Responses

api.docs.get_similar_count

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string
query Parameters
by_label
string

filter for particular label only, or null/!null for filtering out labeled, not labeled

limit
number

stop condition, max count to be returned

min_score
number

minimum similarity score to limit to result for simularity based request. Must be number between 0 and 1.

Responses

api.docs.analyze_doc

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string
query Parameters
select
required
Array of strings

Responses

api.docs.get_predicted_labels_scores

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string

Responses

api.docs.predict_likely_labels

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string

Responses

api.docs.label_similarity_pair

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
doc_id
required
string
query Parameters
label
required
boolean
Request Body schema: application/json
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

api.docs.delete_all

Authorizations:
ApiSecurity
path Parameters
project_id
required
string

Responses

api.docs.search

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
topic_id
string

filter for find only the docs for topic

keyword
string

keyword to find in all text documents

similar_to_doc
string

id of document to search similar docs to

similar_to_phrase
string

text or phrase to search similar document to

min_score
number

minimum similarity score to limit to result for simularity based request. Must be number between 0 and 1.

by_label
string

filtering by label ... special values - 'null' / '!null' for filtering with any or none label

key
string

key of document

false_positives
string

label to search for in falsly positive predicted labels on documents

false_negatives
string

label to search for in falsly negagtive predicted labels on documents

predicted_label
string

label that was predicted on document

prediction_certainty
string

preduction certainty of predicted_label (if number is negative, it's certainty of not predition that label)

prediction_comparsion
string

prediction difference ... with + or - prefix whether new prediciton has extra label

order_by
string

set the order and order field... for descending fields needs to start with "-"ň

after
number

get records after provided order number. Order number is a unumber as the records are stored in database

before
number

get records before provided order number. Order number is a unumber as the records are stored in database

skip
integer
Default: 0

number of documents to skip in result before fetching

take
integer
Default: 50

max number of documents to load

Responses

api.docs.query

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
order_by
string
take
integer
skip
integer
Default: 50
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.docs.delete_query

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
wait_for_completion
boolean
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.docs.get_closest_neigbours

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.docs.export_to_file

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
query Parameters
format
required
string
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.docs.set_labels

Authorizations:
ApiSecurity
path Parameters
project_id
required
string
Request Body schema: application/json
doc_ids
Array of strings
labels
Array of strings

Responses

Request samples

Content type
application/json
{
  • "doc_ids": [
    ],
  • "labels": [
    ]
}

serving

api.serving.get_nodes

Authorizations:
ApiSecurity

Responses

api.serving.create_node

Authorizations:
ApiSecurity
Request Body schema: application/json
node_name
string
node_type
string
deployment_type
string
status
string

Responses

Request samples

Content type
application/json
{
  • "node_name": "string",
  • "node_type": "string",
  • "deployment_type": "string",
  • "status": "string"
}

api.serving.get_node

Authorizations:
ApiSecurity
path Parameters
node_name
required
string

Responses

api.serving.patch_node_info

Authorizations:
ApiSecurity
path Parameters
node_name
required
string
Request Body schema: application/json
node_name
string
node_type
string
deployment_type
string
status
string

Responses

Request samples

Content type
application/json
{
  • "node_name": "string",
  • "node_type": "string",
  • "deployment_type": "string",
  • "status": "string"
}

api.serving.delete_node

Authorizations:
ApiSecurity
path Parameters
node_name
required
string

Responses

api.serving.start

Authorizations:
ApiSecurity
path Parameters
node_name
required
string

Responses

api.serving.stop

Authorizations:
ApiSecurity
path Parameters
node_name
required
string

Responses

api.serving.get_settings

Authorizations:
ApiSecurity
path Parameters
node_name
required
string

Responses

api.serving.update_settings

Authorizations:
ApiSecurity
path Parameters
node_name
required
string
Request Body schema: application/json
default_model
string
models
Array of objects

Responses

Request samples

Content type
application/json
{
  • "default_model": "string",
  • "models": [
    ]
}

api.serving.analyze_settings

Authorizations:
ApiSecurity
path Parameters
node_name
required
string
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

api.serving.ping

Authorizations:
ApiSecurity
path Parameters
node_name
required
string
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

integration modules

api.integrations.get_modules

Authorizations:
ApiSecurity
query Parameters
project_id
required
string

if set, only modules for that project will be selected, else only global modules

Responses

api.integrations.get_module

Authorizations:
ApiSecurity
path Parameters
connector
required
string

if set, only modules for that project will be selected, else only global modules

Responses

api.integrations.save_settings

Authorizations:
ApiSecurity
path Parameters
connector
required
string

if project data should be downloaded from source and processed

query Parameters
project_id
string

id of project for which the settings are valid

Request Body schema: application/json

any settings to be saved to connector

object

Responses

Request samples

Content type
application/json
{ }

api.integrations.get_settings

Authorizations:
ApiSecurity
path Parameters
connector
required
string

if project data should be downloaded from source and processed

query Parameters
project_id
string

id of project for which the settings are valid

Responses

api.integrations.put_metadata

Authorizations:
ApiSecurity
path Parameters
connector
required
string

if project data should be downloaded from source and processed

key
required
string

metadata key

Request Body schema: application/json

any settings to be saved to connector

object

Responses

Request samples

Content type
application/json
{ }

api.integrations.get_metadata

Authorizations:
ApiSecurity
path Parameters
connector
required
string

if project data should be downloaded from source and processed

key
required
string

metadata key

Responses

users

api.users.get_tennant_users

Authorizations:
ApiSecurity

Responses

api.users.update_user

Authorizations:
ApiSecurity
path Parameters
user_id
required
string
Request Body schema: application/json

data to update

object

Responses

Request samples

Content type
application/json
{ }

api.users.get_sessions

Authorizations:
ApiSecurity
path Parameters
user_id
required
string
query Parameters
from_date
required
string
to_date
string

Responses

api.users.get_latest_session

Authorizations:
ApiSecurity
path Parameters
user_id
required
string

Responses

api.users.get_tennant_info

Authorizations:
ApiSecurity

Responses