Program interface for Veeroute Registry.
Create new folder.
Request to create a folder. In the parent_key field, you must specify the key of the folder in which the new folder will be created. If parent_key is not specified, the folder is created in the root.
| parent_key | string or null <uuid> (folder_parent_key) Example: "11111111-2222-3333-4444-555555555555" Parent folder key, |
| name required | string (folder_name) [ 1 .. 100 ] characters Example: "folder_1" Folder name. |
| comment | string or null (folder_comment) [ 0 .. 10000 ] characters Example: "long long long long text" Folder comment. |
| color | string or null (folder_color) [ 1 .. 20 ] characters Example: "red" Folder color. |
| expiration_date | string or null <date-time> (folder_expiration_date) Example: "2026-04-21T19:45:00Z" Date and time of automatic deletion in the ISO 8601 format. Null means that automatic deletion does not occur. |
Array of objects (attributes) [ 0 .. 250 ] items unique Attributes. Used to add service information. |
New folder key.
{- "parent_key": "11111111-2222-3333-4444-555555555555",
- "name": "folder_1",
- "comment": "long long long long text",
- "color": "red",
- "expiration_date": "2026-04-21T19:45:00Z",
- "attributes": [ ]
}"11111111-2222-3333-4444-555555555555"Getting a filesystem.
| folder_key | string <uuid> (unique_key) Example: folder_key=11111111-2222-3333-4444-555555555555 Parent folder key, if not specified - a list of root folders is returned |
| filter | string [ 1 .. 64 ] characters Example: filter=example text Filter for searching by text fields - only those folders that contain a substring from the filter are returned:
|
| offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
| limit | integer <int32> [ 1 .. 2001 ] Default: 100 Example: limit=10 The number of items to return. |
| sort_field | string (filesystem_column_type) Default: "NAME" Enum: "NAME" "OWNER_COMPANY_KEY" "OWNER_USERNAME" … 4 more Example: sort_field=CREATION_DATE The name of the column in the table with folders. |
| sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
required | object (folder) Folder is an element of a virtual file system. |
required | Array of objects (folder) [ 0 .. 2001 ] items List of folders. |
required | object (table_list_counters) Counters by list. |
{- "folders": [
- {
- "key": "2bff0b86-2ddc-445c-9d98-f75ca2eec091",
- "parent_key": "65fb88e5-128d-4f3f-9a50-4c2754adcbed",
- "name": "My Folder",
- "owner_company_key": "veeroute",
- "owner_username": "username_1",
- "comment": "long text",
- "counters": {
- "folders_count": 0,
- "files_count": 3
}
}
], - "counters": {
- "overall": {
- "total": 20
}, - "filter": {
- "total": 1
}
}
}Rename and move folder.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
Folder update request.
| parent_key | string or null <uuid> (folder_parent_key) Example: "11111111-2222-3333-4444-555555555555" Parent folder key, |
| name required | string (folder_name) [ 1 .. 100 ] characters Example: "folder_1" Folder name. |
| comment | string or null (folder_comment) [ 0 .. 10000 ] characters Example: "long long long long text" Folder comment. |
| color | string or null (folder_color) [ 1 .. 20 ] characters Example: "red" Folder color. |
| expiration_date | string or null <date-time> (folder_expiration_date) Example: "2026-04-21T19:45:00Z" Date and time of automatic deletion in the ISO 8601 format. Null means that automatic deletion does not occur. |
Array of objects (attributes) [ 0 .. 250 ] items unique Attributes. Used to add service information. |
required | object (folder) Folder is an element of a virtual file system. |
required | Array of objects (folder) [ 0 .. 2001 ] items List of folders. |
required | object (table_list_counters) Counters by list. |
{- "parent_key": "11111111-2222-3333-4444-555555555555",
- "name": "folder_1",
- "comment": "long long long long text",
- "color": "red",
- "expiration_date": "2026-04-21T19:45:00Z",
- "attributes": [ ]
}{- "folders": [
- {
- "key": "2bff0b86-2ddc-445c-9d98-f75ca2eec091",
- "parent_key": "65fb88e5-128d-4f3f-9a50-4c2754adcbed",
- "name": "My Folder",
- "owner_company_key": "veeroute",
- "owner_username": "username_1",
- "comment": "long text",
- "counters": {
- "folders_count": 0,
- "files_count": 3
}
}
], - "counters": {
- "overall": {
- "total": 20
}, - "filter": {
- "total": 1
}
}
}Folder removal by key.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Getting a folder specification.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
| parent_key | string or null <uuid> (folder_parent_key) Example: "11111111-2222-3333-4444-555555555555" Parent folder key, |
| name required | string (folder_name) [ 1 .. 100 ] characters Example: "folder_1" Folder name. |
| comment | string or null (folder_comment) [ 0 .. 10000 ] characters Example: "long long long long text" Folder comment. |
| color | string or null (folder_color) [ 1 .. 20 ] characters Example: "red" Folder color. |
| expiration_date | string or null <date-time> (folder_expiration_date) Example: "2026-04-21T19:45:00Z" Date and time of automatic deletion in the ISO 8601 format. Null means that automatic deletion does not occur. |
Array of objects (attributes) [ 0 .. 250 ] items unique Attributes. Used to add service information. |
{- "parent_key": "11111111-2222-3333-4444-555555555555",
- "name": "folder_1",
- "comment": "long long long long text",
- "color": "red",
- "expiration_date": "2026-04-21T19:45:00Z",
- "attributes": [ ]
}Folder path.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
required | Array of objects (folder) [ 0 .. 1000 ] items List of folders. |
{- "folders": [
- {
- "key": "11111111-2222-3333-4444-555555555555",
- "type": "FOLDER",
- "parent_key": "11111111-2222-3333-4444-555555555555",
- "name": "folder_1",
- "comment": "long long long long text",
- "color": "red",
- "attributes": [ ],
- "owner_company_key": "smart_company",
- "owner_username": "username_for_login",
- "creation_date": "2026-04-21T19:45:00Z",
- "expiration_date": "2026-04-21T19:45:00Z",
- "counters": {
- "folders_count": 12,
- "files_count": 16
}
}
]
}Create new folder (batch).
Request to create a group of folders from the root of the virtual file system.
If any folder in the path already exists - it will not be created again.
The method returns the key of the last folder, even if no folders were created.
Folder name.
Last folder key.
[ ]"11111111-2222-3333-4444-555555555555"Batch delete folders.
List of folder keys that need to be deleted.
Key, unique identifier.
[ ]{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Getting a folder key by path.
Request to get a folder key by path from the root of the virtual filesystem. If any folder in the path not exists - 404 will be returned.
Folder name.
Last folder key.
[ ]"11111111-2222-3333-4444-555555555555"Getting a file key by path.
Request to get a folder key by path from the root of the virtual filesystem. If in the folder multiple files with the same name - the last modified will be returned. If any folder or file in the path not exists - 404 will be returned.
| folder_names required | Array of strings (folder_name_list) [ 0 .. 10 ] items [ items [ 1 .. 100 ] characters ] Example: ["folder_1"] List of folder names from the root of the virtual filesystem. |
| file_name required | string (file_name) [ 1 .. 100 ] characters Example: "file_1" File name. |
File key.
{- "folder_names": [ ],
- "file_name": "file_1"
}"11111111-2222-3333-4444-555555555555"Batch delete files.
List of file's keys that need to be deleted.
Key, unique identifier.
[ ]{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Getting a virtual filesystem counters.
required | object (folder_counters) Current number of available folders/files. |
required | object (folder_counters) Max number of available folders/files. |
{- "current": {
- "folders_count": 12,
- "files_count": 16
}, - "max": {
- "folders_count": 12,
- "files_count": 16
}
}Export folder with experiments.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
ZIP archive with data.
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Import folder with experiments. The folder should not be of type ROOT and should be empty.
| target_folder_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
Data (ZIP).
ZIP archive with data.
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Create new configuration file.
file create request.
| name required | string (file_name) [ 1 .. 100 ] characters Example: "file_1" File name. |
| comment required | string or null (file_comment) [ 0 .. 10000 ] characters Example: "long long long long text" File comment. |
| folder_key required | string <uuid> (unique_key) Example: "11111111-2222-3333-4444-555555555555" The key of the folder of type |
New configuration file key.
{- "name": "file_1",
- "comment": "long long long long text",
- "folder_key": "11111111-2222-3333-4444-555555555555"
}"11111111-2222-3333-4444-555555555555"Getting configuration file by key.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
| key required | string <uuid> (unique_key) Example: "11111111-2222-3333-4444-555555555555" Key, unique identifier. |
required | object (file_specification) File specification. |
| content required | string (configuration_content) [ 0 .. 2000000 ] characters Example: "{\"long json\"}" Settings in JSON format. |
| json_schema required | string or null (configuration_json_schema) [ 0 .. 2000000 ] characters Example: "{\"$schema\":\"https://json-schema.org/draft/2020-12/schema\", \"type\":\"object\", \"additionalProperties\":true}" Schema for validating content (settings) in JSON Schema format. |
| edit_date required | string <date-time> (file_edit_date) Example: "2026-04-21T19:45:00Z" Last file edit date and time in the ISO 8601 format. |
| creation_date required | string <date-time> (file_creation_date) Example: "2026-04-21T19:45:00Z" File creation date and time in the ISO 8601 format. |
{- "key": "da4e62b0-86cb-4423-b187-5c1a433ca703",
- "specification": {
- "name": "new-cfg-5",
- "comment": "just run it",
- "folder_key": "2bff0b86-2ddc-445c-9d98-f75ca2ee4091"
}, - "content": "{}",
- "json_schema": "{'$schema': 'https://json-schema.org/draft/2020-12/schema'}",
- "edit_date": "2026-04-15T13:56:07.728Z",
- "creation_date": "2026-04-15T13:56:07.728Z"
}Rename \ move configuration.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Configuration specification update request.
| name required | string (file_name) [ 1 .. 100 ] characters Example: "file_1" File name. |
| comment required | string or null (file_comment) [ 0 .. 10000 ] characters Example: "long long long long text" File comment. |
| folder_key required | string <uuid> (unique_key) Example: "11111111-2222-3333-4444-555555555555" The key of the folder of type |
| key required | string <uuid> (unique_key) Example: "11111111-2222-3333-4444-555555555555" Key, unique identifier. |
required | object (file_specification) File specification. |
| content required | string (configuration_content) [ 0 .. 2000000 ] characters Example: "{\"long json\"}" Settings in JSON format. |
| json_schema required | string or null (configuration_json_schema) [ 0 .. 2000000 ] characters Example: "{\"$schema\":\"https://json-schema.org/draft/2020-12/schema\", \"type\":\"object\", \"additionalProperties\":true}" Schema for validating content (settings) in JSON Schema format. |
| edit_date required | string <date-time> (file_edit_date) Example: "2026-04-21T19:45:00Z" Last file edit date and time in the ISO 8601 format. |
| creation_date required | string <date-time> (file_creation_date) Example: "2026-04-21T19:45:00Z" File creation date and time in the ISO 8601 format. |
{- "name": "file_1",
- "comment": "long long long long text",
- "folder_key": "11111111-2222-3333-4444-555555555555"
}{- "key": "da4e62b0-86cb-4423-b187-5c1a433ca703",
- "specification": {
- "name": "new-cfg-5",
- "comment": "just run it",
- "folder_key": "2bff0b86-2ddc-445c-9d98-f75ca2ee4091"
}, - "content": "{}",
- "json_schema": "{'$schema': 'https://json-schema.org/draft/2020-12/schema'}",
- "edit_date": "2026-04-15T13:56:07.728Z",
- "creation_date": "2026-04-15T13:56:07.728Z"
}Configuration removal by key.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Schema read.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Schema for validating content (settings) in JSON Schema format.
"{\"$schema\":\"https://json-schema.org/draft/2020-12/schema\", \"type\":\"object\", \"additionalProperties\":true}"Schema update.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Configuration schema update request.
Schema for validating content (settings) in JSON Schema format.
"{\"$schema\":\"https://json-schema.org/draft/2020-12/schema\", \"type\":\"object\", \"additionalProperties\":true}"{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Content read.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Settings in JSON format.
"{\"long json\"}"Content update.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Configuration content update request.
Settings in JSON format.
"{\"long json\"}"{- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2026-04-21T09:30:00+03:00"
}, - "message": "bad data",
- "schema_errors": [ ]
}Getting a table with configuration.
| folder_key | string <uuid> (unique_key) Example: folder_key=11111111-2222-3333-4444-555555555555 Folder key, unique identifier. |
| filter | string [ 1 .. 64 ] characters Example: filter=example text Filter for searching by text fields - only those files are returned whose name or description contains a substring from the filter. If the filter is empty, all files in the folder are returned. The results are sorted by editing time. |
| offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
| limit | integer <int32> [ 1 .. 2001 ] Default: 100 Example: limit=10 The number of items to return. |
| sort_field | string (table_configuration_column_type) Default: "SPECIFICATION_NAME" Enum: "ESSENCE_KEY" "CREATION_DATE" "EDIT_DATE" … 3 more Example: sort_field=SPECIFICATION_FOLDER_KEY Configuration table column name. |
| sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
required | Array of objects (table_configuration) [ 0 .. 2001 ] items A list of configurations. |
required | object (table_list_counters) Counters by list. |
{- "essences": [
- {
- "essence_key": "da4e62b0-86cb-4423-b187-5c1a433ca703",
- "specification": {
- "name": "new-cfg-5",
- "comment": "just run it",
- "folder_key": "2bff0b86-2ddc-445c-9d98-f75ca2ee4091"
}, - "edit_date": "2026-04-15T13:56:07.728Z",
- "creation_date": "2026-04-15T13:56:07.728Z"
}
], - "counters": {
- "overall": {
- "total": 1
}, - "filter": {
- "total": 1
}
}
}Configuration global search.
| filter required | string [ 3 .. 128 ] characters Example: filter=example text Filter for searching by text fields - only those configurations are returned whose name or description contains a substring from the filter. If the filter is empty, an empty list is returned. By default the results are sorted by editing time. |
| offset | integer <int32> [ 0 .. 10000000 ] Default: 0 Example: offset=10 The number of items to skip before starting to collect the result set. |
| limit | integer <int32> [ 1 .. 2001 ] Default: 100 Example: limit=10 The number of items to return. |
| sort_field | string (table_configuration_column_type) Default: "SPECIFICATION_NAME" Enum: "ESSENCE_KEY" "CREATION_DATE" "EDIT_DATE" … 3 more Example: sort_field=SPECIFICATION_FOLDER_KEY Configuration table column name. |
| sort_direction | string Default: "ASC" Enum: "ASC" "DESC" Example: sort_direction=DESC Sort direction. |
required | Array of objects (table_configuration) [ 0 .. 2001 ] items A list of configurations. |
required | object (table_list_counters) Counters by list. |
{- "essences": [
- {
- "essence_key": "da4e62b0-86cb-4423-b187-5c1a433ca703",
- "specification": {
- "name": "new-cfg-5",
- "comment": "just run it",
- "folder_key": "2bff0b86-2ddc-445c-9d98-f75ca2ee4091"
}, - "edit_date": "2026-04-15T13:56:07.728Z",
- "creation_date": "2026-04-15T13:56:07.728Z"
}
], - "counters": {
- "overall": {
- "total": 1
}, - "filter": {
- "total": 1
}
}
}Configuration duplicate.
| file_key required | string <uuid> (unique_key) Example: 11111111-2222-3333-4444-555555555555 File key, unique identifier. |
Configuration duplicate request.
| name required | string (file_name) [ 1 .. 100 ] characters Example: "file_1" File name. |
| comment required | string or null (file_comment) [ 0 .. 10000 ] characters Example: "long long long long text" File comment. |
| folder_key required | string <uuid> (unique_key) Example: "11111111-2222-3333-4444-555555555555" The key of the folder of type |
Duplicated configuration key.
{- "name": "file_1",
- "comment": "long long long long text",
- "folder_key": "11111111-2222-3333-4444-555555555555"
}"11111111-2222-3333-4444-555555555555"Checking the service availability.
| health required | number <double> [ 0 .. 1 ] Example: "0.999" The current health indicator of the service.
|
{- "health": 0.999
}Getting the service version.
| major required | integer <int32> [ 1 .. 100 ] Example: "7" Product version. Within a single version, compatibility of common data structures between services is guaranteed. A version change indicates changes that are incompatible with previous versions of the product (and all services). |
| minor required | integer <int32> [ 0 .. 111 ] Example: "15" Minor version of the service. A version change indicates new functionality. The update is backward compatible with the major version of the service. |
| build required | string [ 1 .. 64 ] characters Example: "3754RC" Build version. |
{- "major": 7,
- "minor": 15,
- "build": "3754RC"
}Getting the file with this service documentation.
| filename required | string [ 6 .. 128 ] characters Example: file_en.html File name. |
File with data in HTML format.
{- "resource_key": "resource_key_one",
- "detail": null
}