Workspaces

put

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

engine_idstringRequired

Body

application/json

seed_valueany ofOptionalDefault: null

integerOptional

or

nullOptional

use_seedany ofOptionalDefault: null

booleanOptional

or

nullOptional

pii_model_settingsany ofOptionalDefault: null

objectOptional

or

nullOptional

initialization_modeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

n_parallel_pipeline_processesany ofOptionalDefault: null

integerOptional

or

nullOptional

default_n_training_rowsany ofOptionalDefault: null

integerOptional

or

nullOptional

default_read_random_subsetany ofOptionalDefault: null

booleanOptional

or

nullOptional

default_sample_noise_ratioany ofOptionalDefault: null

numberOptional

or

nullOptional

default_max_n_feat_per_modelany ofOptionalDefault: null

integerOptional

or

nullOptional

default_feat_model_train_orderany ofOptionalDefault: null

stringOptional

or

nullOptional

default_max_sequence_lengthany ofOptionalDefault: null

integerOptional

or

nullOptional

default_end_of_sequence_tokenany ofOptionalDefault: null

numberOptional

or

nullOptional

default_cardinality_thresholdany ofOptionalDefault: null

integerOptional

or

nullOptional

default_rare_category_replacementany ofOptionalDefault: null

stringOptional

or

nullOptional

default_clip_thresholdany ofOptionalDefault: null

integerOptional

or

nullOptional

default_localeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

default_pii_mock_replaceany ofOptionalDefault: null

booleanOptional

or

nullOptional

default_noise_factorany ofOptionalDefault: null

numberOptional

or

nullOptional

default_text_processor_model_settingsany ofOptionalDefault: null

objectOptional

or

nullOptional

default_textpii_parallel_jobsany ofOptionalDefault: null

integerOptional

or

nullOptional

default_textpii_scan_batch_sizeany ofOptionalDefault: null

integerOptional

or

nullOptional

default_cutoff_lengthany ofOptionalDefault: null

integerOptional

or

nullOptional

default_long_sequence_thresholdany ofOptionalDefault: null

integerOptional

or

nullOptional

default_min_sample_sizeany ofOptionalDefault: null

integerOptional

or

nullOptional

default_fast_executemanyany ofOptionalDefault: null

booleanOptional

or

nullOptional

default_consistent_integer_shuffle_thresholdany ofOptionalDefault: null

integerOptional

or

nullOptional

default_order_by_nr_columnsany ofOptionalDefault: null

or

nullOptional

default_max_pending_tasksany ofOptionalDefault: null

integerOptional

or

nullOptional

default_exclude_tablesany ofOptionalDefault: false

booleanOptional

or

nullOptional

idstring · uuidRequired

set_defaultsany ofOptionalDefault: true

booleanOptional

or

nullOptional

Responses

200Success

application/json

task_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

engine_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

statusstringRequired

put

/api/v1/engine/{engine_id}/update-settings/

HTTPcURLJavaScriptPython

PUT /api/v1/engine/{engine_id}/update-settings/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1018

{
  "seed_value": 1,
  "use_seed": true,
  "pii_model_settings": {},
  "initialization_mode": "SYNTHESIZE",
  "key_generation_method": "duplicate",
  "n_parallel_pipeline_processes": 1,
  "default_n_training_rows": 1,
  "default_read_random_subset": true,
  "default_sample_noise_ratio": 1,
  "default_max_n_feat_per_model": 1,
  "default_feat_model_train_order": "text",
  "default_max_sequence_length": 1,
  "default_end_of_sequence_token": 1,
  "default_cardinality_threshold": 1,
  "default_rare_category_replacement": "text",
  "default_clip_threshold": 1,
  "default_locale": "en",
  "default_pii_mock_replace": true,
  "default_noise_factor": 1,
  "default_text_processor_model_settings": {},
  "default_textpii_parallel_jobs": 1,
  "default_textpii_scan_batch_size": 1,
  "default_cutoff_length": 1,
  "default_long_sequence_threshold": 1,
  "default_min_sample_size": 1,
  "default_fast_executemany": true,
  "default_consistent_integer_shuffle_threshold": 1,
  "default_order_by_nr_columns": [],
  "default_max_pending_tasks": 1,
  "default_exclude_tables": false,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "set_defaults": true
}

200Success

{
  "task_id": "123e4567-e89b-12d3-a456-426614174000",
  "engine_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "text"
}

get

List workspace

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Responses

200

Success: Workspace List

application/json

get

/api/v1/workspaces/

HTTPcURLJavaScriptPython

GET /api/v1/workspaces/ HTTP/1.1
Accept: */*

200

Success: Workspace List

{
  "workspaces": [
    {
      "pk": 1,
      "name": "text",
      "organization": 1,
      "engine_id": "text",
      "owner_name": "text",
      "created_at": "2026-04-03T08:29:15.166Z",
      "status": "text",
      "engine": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "latest_job_status": "STARTED",
        "connector_type": "text",
        "source_database_status": "CURRENT"
      },
      "initialization_mode": "SYNTHESIZE",
      "key_generation_method": "duplicate",
      "default_locale": "en"
    }
  ]
}

post

Create a new workspace and engine

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Query parameters

sample_dbstringOptional

The sample database to use

Body

application/json

initialization_modeany ofOptionalDefault: DE_IDENTIFY

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: duplicate

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: en

string · enumOptionalPossible values:

or

nullOptional

default_exclude_tablesany ofOptionalDefault: false

booleanOptional

or

nullOptional

source_connectionone ofRequired

or

or

or

or

or

or

target_connectionany ofOptionalDefault: null

anyOptional

or

or

or

or

or

or

or

or

or

nullOptional

namestringRequired

organizationintegerRequired

Responses

200

Success: Created workspace

application/json

pkany ofOptionalDefault: null

integerOptional

or

nullOptional

namestringRequired

organizationintegerRequired

engine_idany ofOptionalDefault: null

stringOptional

or

nullOptional

owner_nameany ofOptionalDefault: null

stringOptional

or

nullOptional

created_atany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

statusany ofOptionalDefault: null

stringOptional

or

nullOptional

engineany ofOptionalDefault: null

or

nullOptional

initialization_modeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

400

Failed

application/json

post

/api/v1/workspaces/

HTTPcURLJavaScriptPython

POST /api/v1/workspaces/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1273

{
  "initialization_mode": "DE_IDENTIFY",
  "key_generation_method": "duplicate",
  "default_locale": "en",
  "default_exclude_tables": false,
  "source_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1433,
    "protocol": "mssql+pyodbc",
    "include_views": false
  },
  "target_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1433,
    "protocol": "mssql+pyodbc",
    "include_views": false
  },
  "name": "text",
  "organization": 1
}

{
  "pk": 1,
  "name": "text",
  "organization": 1,
  "engine_id": "text",
  "owner_name": "text",
  "created_at": "2026-04-03T08:29:15.166Z",
  "status": "text",
  "engine": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "latest_job_status": "STARTED",
    "connector_type": "text",
    "source_database_status": "CURRENT"
  },
  "initialization_mode": "SYNTHESIZE",
  "key_generation_method": "duplicate",
  "default_locale": "en"
}

get

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Responses

200Success

application/json

pkany ofOptionalDefault: null

integerOptional

or

nullOptional

namestringRequired

organizationintegerRequired

engine_idany ofOptionalDefault: null

stringOptional

or

nullOptional

owner_nameany ofOptionalDefault: null

stringOptional

or

nullOptional

created_atany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

statusany ofOptionalDefault: null

stringOptional

or

nullOptional

engineany ofOptionalDefault: null

or

nullOptional

initialization_modeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

get

/api/v1/workspaces/{id}/

HTTPcURLJavaScriptPython

GET /api/v1/workspaces/{id}/ HTTP/1.1
Accept: */*

200Success

{
  "pk": 1,
  "name": "text",
  "organization": 1,
  "engine_id": "text",
  "owner_name": "text",
  "created_at": "2026-04-03T08:29:15.166Z",
  "status": "text",
  "engine": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "latest_job_status": "STARTED",
    "connector_type": "text",
    "source_database_status": "CURRENT"
  },
  "initialization_mode": "SYNTHESIZE",
  "key_generation_method": "duplicate",
  "default_locale": "en"
}

put

Update a workspace and engine

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Body

application/json

source_connectionany ofOptionalDefault: null

anyOptional

or

or

or

or

or

or

or

nullOptional

target_connectionany ofOptionalDefault: null

anyOptional

or

or

or

or

or

or

or

or

or

nullOptional

key_generation_methodany ofOptionalDefault: duplicate

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: en

string · enumOptionalPossible values:

or

nullOptional

initialization_modeany ofOptionalDefault: DE_IDENTIFY

string · enumOptionalPossible values:

or

nullOptional

namestringRequired

Responses

200

Success: Created workspace

application/json

pkany ofOptionalDefault: null

integerOptional

or

nullOptional

namestringRequired

organizationintegerRequired

engine_idany ofOptionalDefault: null

stringOptional

or

nullOptional

owner_nameany ofOptionalDefault: null

stringOptional

or

nullOptional

created_atany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

statusany ofOptionalDefault: null

stringOptional

or

nullOptional

engineany ofOptionalDefault: null

or

nullOptional

initialization_modeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

400

Failed

application/json

put

/api/v1/workspaces/{id}/

HTTPcURLJavaScriptPython

PUT /api/v1/workspaces/{id}/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1201

{
  "source_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1,
    "protocol": "text",
    "include_views": true
  },
  "target_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1,
    "protocol": "text",
    "include_views": true
  },
  "key_generation_method": "duplicate",
  "default_locale": "en",
  "initialization_mode": "DE_IDENTIFY",
  "name": "text"
}

{
  "pk": 1,
  "name": "text",
  "organization": 1,
  "engine_id": "text",
  "owner_name": "text",
  "created_at": "2026-04-03T08:29:15.166Z",
  "status": "text",
  "engine": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "latest_job_status": "STARTED",
    "connector_type": "text",
    "source_database_status": "CURRENT"
  },
  "initialization_mode": "SYNTHESIZE",
  "key_generation_method": "duplicate",
  "default_locale": "en"
}

delete

Delete a workspace and cancel workspace creation job.

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Responses

204

No response body

delete

/api/v1/workspaces/{id}/

HTTPcURLJavaScriptPython

DELETE /api/v1/workspaces/{id}/ HTTP/1.1
Accept: */*

204

No response body

No content

post

Duplicates a workspace, including permissions

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Body

application/json

source_connectionany ofOptionalDefault: null

anyOptional

or

or

or

or

or

or

or

nullOptional

target_connectionany ofOptionalDefault: null

anyOptional

or

or

or

or

or

or

or

or

or

nullOptional

key_generation_methodany ofOptionalDefault: duplicate

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: en

string · enumOptionalPossible values:

or

nullOptional

initialization_modeany ofOptionalDefault: DE_IDENTIFY

string · enumOptionalPossible values:

or

nullOptional

namestringRequired

Responses

200

Success: Created workspace

application/json

pkany ofOptionalDefault: null

integerOptional

or

nullOptional

namestringRequired

organizationintegerRequired

engine_idany ofOptionalDefault: null

stringOptional

or

nullOptional

owner_nameany ofOptionalDefault: null

stringOptional

or

nullOptional

created_atany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

statusany ofOptionalDefault: null

stringOptional

or

nullOptional

engineany ofOptionalDefault: null

or

nullOptional

initialization_modeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

key_generation_methodany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

default_localeany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

400

Failed

application/json

post

/api/v1/workspaces/{id}/duplicate/

HTTPcURLJavaScriptPython

POST /api/v1/workspaces/{id}/duplicate/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1201

{
  "source_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1,
    "protocol": "text",
    "include_views": true
  },
  "target_connection": {
    "hooks_params": {
      "SSHTunnel": {
        "host": "text",
        "port": 1,
        "username": "text",
        "local_port": 1,
        "local_host": "text",
        "password": "text",
        "pkey_password": "text",
        "pkey": "text"
      },
      "SSL": {
        "ca_filename": "text",
        "cert_filename": "text",
        "key_filename": "text",
        "ssl_mode": "text",
        "ca": "text",
        "cert": "text",
        "key": "text"
      },
      "Kerberos": {
        "principal": "text",
        "keytab_file": "text"
      }
    },
    "is_source": true,
    "connector_type": "text",
    "host": "text",
    "database": "text",
    "username": "text",
    "password": "text",
    "schema_name": "text",
    "port": 1,
    "protocol": "text",
    "include_views": true
  },
  "key_generation_method": "duplicate",
  "default_locale": "en",
  "initialization_mode": "DE_IDENTIFY",
  "name": "text"
}

{
  "pk": 1,
  "name": "text",
  "organization": 1,
  "engine_id": "text",
  "owner_name": "text",
  "created_at": "2026-04-03T08:29:15.166Z",
  "status": "text",
  "engine": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "latest_job_status": "STARTED",
    "connector_type": "text",
    "source_database_status": "CURRENT"
  },
  "initialization_mode": "SYNTHESIZE",
  "key_generation_method": "duplicate",
  "default_locale": "en"
}

get

Export workspace

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Responses

200

Success: Exported Workspace

application/octet-stream

string · binaryOptional

403

Forbidden

404

Not Found

503

Service Unavailable

get

/api/v1/workspaces/{id}/export/

HTTPcURLJavaScriptPython

GET /api/v1/workspaces/{id}/export/ HTTP/1.1
Accept: */*

binary

put

Import workspace

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Body

multipart/form-data

Unspecified request body

Other propertiesanyOptional

Responses

200

Success: Workspace import started

No content

400

Bad Request: Invalid input

503

Service Unavailable: Unable to start workspace import

put

/api/v1/workspaces/{id}/import/

HTTPcURLJavaScriptPython

PUT /api/v1/workspaces/{id}/import/ HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

No content

get

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

idintegerRequired

Responses

200Success

application/json

pkintegerRead-onlyOptional

workspaceintegerRequired

rolestring · enumRequired

• OWNER - Owner
• EDITOR - Editor
• READER - Reader

Possible values:

data_accessbooleanOptional

get

/api/v1/workspaces/{id}/members/

HTTPcURLJavaScriptPython

GET /api/v1/workspaces/{id}/members/ HTTP/1.1
Accept: */*

200Success

[
  {
    "pk": 1,
    "workspace": 1,
    "user": {
      "pk": 1,
      "first_name": "text",
      "last_name": "text",
      "full_name": "text",
      "email": "[email protected]"
    },
    "role": "OWNER",
    "data_access": true
  }
]