Skip to content

Interactive Reference

The full S-Launch OpenAPI specification, rendered as an interactive reference. Every endpoint, every request and response schema, and every model is available here for inspection.

Use this page when you want to:

  • Inspect the full schema of a request or response body.
  • Copy an endpoint signature for a client SDK.
  • Drill into nested model references that the hand-written endpoint pages only mention by name.

The same data is also available as raw openapi.json for import into Postman, Insomnia, Stoplight, and other OpenAPI 3.x tools.

Upload avatar for self

POST
/api/self/avatar

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Request Body

multipart/form-data
object
Format"binary"

Responses

Upload avatar for self

application/json
JSON
[
]

Playground

Server
Authorization
Body

Samples


Get user avatar

GET
/api/users/{id}/avatar

Get the avatar for the user by ID (active only in dev or debug modes)

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

id*
Type
string
Required

Responses

Successful Response

application/json
JSON
[
]

Playground

Server
Authorization
Variables
Key
Value

Samples


Get menu config

GET
/api/ui/menu

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
[
  
{
  
  
"title": "string",
  
  
"icon": "string",
  
  
"link": "string",
  
  
"subItems": [
  
  
  
{
  
  
  
}
  
  
],
  
  
"scopes": [
  
  
  
"string"
  
  
]
  
}
]

Playground

Server
Authorization

Samples


Server Heartbeat


Heartbeat

GET
/api/heartbeat/

Responses

Successful Response

application/json
JSON
{
  
"status": "string",
  
"debug_mode": true,
  
"activated": true,
  
"demo": true,
  
"startup_time": 0,
  
"next_purge": 0,
  
"version": "string",
  
"build_number": 0
}

Playground

Samples


Login

POST
/api/login/access-token

OAuth2 compatible token login, get an access token for future requests

Request Body

application/x-www-form-urlencoded
object
string |null
Default""
string |null
string |null

Responses

Successful Response

application/json
JSON
{
  
"access_token": "string",
  
"token_type": "string"
}

Playground

Server
Body

Samples


Form Submissions


Get Form Submission filter metadata

GET
/api/form/history/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Form Viewer


Get Form filter metadata

GET
/api/form/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Form Builder


Get thumbnail for Dynamic Form by ID

GET
/api/formbuilder/{id}/thumbnail

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

id*
Type
string
Required

Responses

Get thumbnail for form by id

application/json
JSON
[
]

Playground

Server
Authorization
Variables
Key
Value

Samples


Blueprints


Get thumbnail for workflow template by ID

GET
/api/factory/workflows/{id}/thumbnail

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

id*
Type
string
Required

Responses

Get thumbnail for workflow template by id

application/json
JSON
[
]

Playground

Server
Authorization
Variables
Key
Value

Samples


Tickets


Get Ticket filter metadata

GET
/api/factory/tickets/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Assemblies


Get Assembly filter metadata

GET
/api/factory/history/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Tasks


Get Task filter metadata

GET
/api/factory/tasks/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Blueprint Builder Helpers


Get factory UCS allowed scopes

GET
/api/factory/ucs-allowed-scopes

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
[
  
"string"
]

Playground

Server
Authorization

Samples


Asset Store


Get Store Object By Url

GET
/api/store/

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Query Parameters

url
Type
string
Default
""
as_json

Return JSON response

Type
boolean
Default
false
hydrate

Whether to expand referenced objects (default: True). Set to False to return referenced objects as simple IDs/URLs for better performance.

Type
boolean
Default
true

Responses

Get Asset Store object by url

application/json
JSON
{
  
"created": 0,
  
"created_by": {
  
  
"id": "string",
  
  
"login": "Unavailable",
  
  
"name": "Unavailable",
  
  
"surname": "Unavailable"
  
},
  
"modified": 0,
  
"modified_by": {
  
  
"id": "string",
  
  
"login": "Unavailable",
  
  
"name": "Unavailable",
  
  
"surname": "Unavailable"
  
},
  
"name": "string",
  
"control": {
  
  
"system": false,
  
  
"readonly": false,
  
  
"protected": false,
  
  
"hidden": false
  
},
  
"id": "string",
  
"depth": 0,
  
"url": "string",
  
"description": "string",
  
"public": true,
  
"parent": {
  
  
"id": "string",
  
  
"name": "Unavailable",
  
  
"url": "string"
  
},
  
"assets": [
  
  
{
  
  
  
"created": 0,
  
  
  
"modified": 0,
  
  
  
"name": "string",
  
  
  
"control": {
  
  
  
  
"system": false,
  
  
  
  
"readonly": false,
  
  
  
  
"protected": false,
  
  
  
  
"hidden": false
  
  
  
},
  
  
  
"id": "string",
  
  
  
"mime_type": "string",
  
  
  
"type": "string",
  
  
  
"size": 0,
  
  
  
"url": "string"
  
  
}
  
],
  
"folders": [
  
  
{
  
  
  
"created": 0,
  
  
  
"modified": 0,
  
  
  
"name": "string",
  
  
  
"control": {
  
  
  
  
"system": false,
  
  
  
  
"readonly": false,
  
  
  
  
"protected": false,
  
  
  
  
"hidden": false
  
  
  
},
  
  
  
"id": "string",
  
  
  
"url": "string",
  
  
  
"public": true
  
  
}
  
]
}

Playground

Server
Authorization
Variables
Key
Value

Samples


Folders


Download Folder

GET
/api/store/folder/{id}/download

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

id*
Type
string
Required

Responses

Successful Response

Playground

Server
Authorization
Variables
Key
Value

Samples


Assets


Upload Asset

POST
/api/store/asset/upload

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Query Parameters

folder

Request Body

multipart/form-data
object
Format"binary"

Responses

Successful Response

application/json
JSON
{
  
"created": 0,
  
"created_by": {
  
  
"id": "string",
  
  
"login": "Unavailable",
  
  
"name": "Unavailable",
  
  
"surname": "Unavailable"
  
},
  
"modified": 0,
  
"modified_by": {
  
  
"id": "string",
  
  
"login": "Unavailable",
  
  
"name": "Unavailable",
  
  
"surname": "Unavailable"
  
},
  
"name": "string",
  
"control": {
  
  
"system": false,
  
  
"readonly": false,
  
  
"protected": false,
  
  
"hidden": false
  
},
  
"id": "string",
  
"mime_type": "string",
  
"type": "string",
  
"metadata": {
  
  
"additionalProperties": "string"
  
},
  
"size": 0,
  
"url": "string",
  
"folder": {
  
  
"id": "string",
  
  
"name": "Unavailable",
  
  
"url": "string"
  
}
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples


Shares


Get Access To Share

POST
/api/share/get_access

Request Body

application/json
JSON
{
  
"id": "string",
  
"password": "string"
}

Responses

Get access to share

application/json
JSON
{
  
"id": "string",
  
"expires_at": "string",
  
"downloads": 0,
  
"downloads_limit": 0,
  
"description": "string",
  
"created_by": {
  
  
"id": "string",
  
  
"login": "Unavailable",
  
  
"name": "Unavailable",
  
  
"surname": "Unavailable"
  
},
  
"created": "string",
  
"asset": {
  
  
"id": "string",
  
  
"name": "Unavailable",
  
  
"url": "string",
  
  
"mime_type": "string"
  
},
  
"folder": {
  
  
"id": "string",
  
  
"name": "Unavailable",
  
  
"url": "string"
  
},
  
"token": "string"
}

Playground

Server
Body

Samples


Groups


Get Group Users

GET
/api/admin/groups/{id}/users

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

id*
Type
string
Required

Responses

Successful Response

application/json
JSON
[
  
{
  
  
"created": 0,
  
  
"modified": 0,
  
  
"name": "string",
  
  
"control": {
  
  
  
"system": false,
  
  
  
"readonly": false,
  
  
  
"protected": false,
  
  
  
"hidden": false
  
  
},
  
  
"id": "string",
  
  
"surname": "",
  
  
"login": "",
  
  
"email": "noreply@s-launch.com",
  
  
"is_active": false,
  
  
"external": false,
  
  
"is_locked": false,
  
  
"invitation_pending": false
  
}
]

Playground

Server
Authorization
Variables
Key
Value

Samples


Configuration


Get all config keys

GET
/api/admin/config/

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
"string"

Playground

Server
Authorization

Samples


Security Scope Sets


Get Scope Set filter metadata

GET
/api/admin/scope-sets/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Users


Check if email is unique

GET
/api/admin/users/check-email-unique

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Query Parameters

email*
Type
string
Required

Responses

Successful Response

application/json
JSON
[
]

Playground

Server
Authorization
Variables
Key
Value

Samples


System Health


Return detailed service health snapshot

GET
/api/admin/health/{full_service_name}

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Parameters

Path Parameters

full_service_name*
Type
string
Required

Responses

Successful Response

application/json
JSON
{
  
"startup_time": 0,
  
"timestamp": 0,
  
"id": "string",
  
"service": "string",
  
"instance_id": "string",
  
"fullname": "string",
  
"status": "string",
  
"hostname": "string",
  
"version": "string",
  
"pid": 0,
  
"python": "string",
  
"cmd_args": [
  
  
"string"
  
],
  
"uptime": "string",
  
"stale": true
}

Playground

Server
Authorization
Variables
Key
Value

Samples


Api Keys


Get all available API key scopes

GET
/api/admin/api-keys/scopes

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
[
  
"string"
]

Playground

Server
Authorization

Samples


admin, activate


Prepare bootstrap admin

POST
/api/activate/

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Request Body

application/json
JSON
{
  
"general": {
  
  
"project_name": "S-Launch",
  
  
"company_name": "Significans Inc.",
  
  
"default_language": "en",
  
  
"default_timezone": "UTC"
  
},
  
"mail": {
  
  
"sender_addr": "string",
  
  
"sender_name": "string",
  
  
"smtp_options": {
  
  
  
"host": "string",
  
  
  
"port": 0,
  
  
  
"ssl": false,
  
  
  
"user": "string",
  
  
  
"password": "string"
  
  
}
  
},
  
"admin_user": {
  
  
"name": "string",
  
  
"surname": "string",
  
  
"mail": "string"
  
}
}

Responses

Successful Response

application/json
JSON
"string"

Playground

Server
Authorization
Body

Samples


Sessions


Get Session filter metadata

GET
/api/admin/sessions/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Index Management


Get list of available models for index management

GET
/api/admin/indexes/models

Get list of all available models for index management.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
[
  
"string"
]

Playground

Server
Authorization

Samples


Defaults


List default object recreate targets

GET
/api/admin/defaults/

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"targets": [
  
  
"string"
  
]
}

Playground

Server
Authorization

Samples


Admin Push


Receive Enrollment

POST
/api/admin-push/enrollment

Receive an enrollment token pushed by the admin portal.
Calls back to admin for mutual verification and credential exchange.

Request Body

application/json
JSON
{
  
"enrollment_token": "string"
}

Responses

Successful Response

application/json
JSON
[
]

Playground

Server
Body

Samples


Metadata


Get Route filter metadata

GET
/api/meta/routes/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Audit Logging


Get Audit Log filter metadata

GET
/api/logging/audit/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


System Logging


Get System Log filter metadata

GET
/api/logging/system/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Themes


Get active theme

GET
/api/themes/active

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"id": "string",
  
"name": "string",
  
"description": "string",
  
"is_active": true,
  
"dark_active": true,
  
"colors": {
  
  
"additionalProperties": "string"
  
},
  
"images": {
  
  
"additionalProperties": "string"
  
},
  
"colors_dark": {
  
  
"additionalProperties": "string"
  
},
  
"images_dark": {
  
  
"additionalProperties": "string"
  
},
  
"control": {
  
  
"system": false,
  
  
"readonly": false,
  
  
"protected": false,
  
  
"hidden": false
  
},
  
"custom": {
  
  
"additionalProperties": "string"
  
},
  
"custom_dark": {
  
  
"additionalProperties": "string"
  
}
}

Playground

Server
Authorization

Samples


Mail Templates


Get Mail Template filter metadata

GET
/api/mailtemplates/filters

Returns metadata about available filters, operators, and sorting options
for this model. This endpoint helps frontend applications dynamically
build filter and sort UIs.

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/login/access-token"
Scopes:
or
APIKeyHeader
Type
API Key (header: X-API-Key)

Responses

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground

Server
Authorization

Samples


Powered by VitePress OpenAPI