API Documentation

Health Check

Health Check

get

Responses

200

Successful Response

application/json

Responseany

get

/health

HTTPcURLJavaScriptPython

GET /health HTTP/1.1
Host: 
Accept: */*

200

Successful Response

No content

Tenant Options

Get Tenant Options

Get Tenant Options

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/tenant-options

HTTPcURLJavaScriptPython

GET /v1/tenant-options HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "options_values": [
    {
      "name": "text",
      "values": [
        "text"
      ]
    }
  ]
}

Add Tenant Options

Add Tenant Options

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Body

application/json

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/tenant-options

HTTPcURLJavaScriptPython

POST /v1/tenant-options HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "options": [
    {
      "name": "text",
      "values": [
        "text"
      ]
    }
  ]
}

{
  "message": "text"
}

Product Options

Get Product Options

Get Product Options

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Query parameters

limitany ofOptional

Maximum number of records to return

integer · min: 1Optional

or

nullOptional

offsetany ofOptional

Number of records to skip

integerOptional

or

nullOptional

Header parameters

correlation-idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/product-options

HTTPcURLJavaScriptPython

GET /v1/product-options HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "options_values": [
    {
      "product": "text",
      "option_values": [
        {
          "option_name": "text",
          "option_values": [
            "text"
          ]
        }
      ]
    }
  ]
}

Add Product Options

Add Product Options

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Body

application/json

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/product-options

HTTPcURLJavaScriptPython

POST /v1/product-options HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "product_options": [
    {
      "product": "text",
      "option_values": [
        {
          "option_name": "text",
          "option_values": [
            "text"
          ]
        }
      ]
    }
  ]
}

{
  "message": "text"
}

Tenant Data Connection Configs

Get Tenant Data Connections

Get Tenant Data Conn

get

Get all data connection configs for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/tenant-data-conn-configs

HTTPcURLJavaScriptPython

GET /v1/tenant-data-conn-configs HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "data_connections": [
    {
      "name": "text",
      "type": "text",
      "configs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

Create Tenant Data Connections

Create Tenant Data Conn

post

Add data connection configs for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Body

application/json

Request model for adding one or more data‐connection configs to a tenant.

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/tenant-data-conn-configs

HTTPcURLJavaScriptPython

POST /v1/tenant-data-conn-configs HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "data_connections": [
    {
      "name": "text",
      "type": "text",
      "configs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

{
  "message": "text"
}

Update Tenant Data Connection

Update Tenant Data Conn

patch

Update data‑connection config by name for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

namestringRequired

Header parameters

correlation-idstringRequired

Body

application/json

typeany ofOptional

New connection type, if updating

stringOptional

or

nullOptional

configsany ofOptional

New configs map, if updating

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

patch

/v1/tenant-data-conn-configs/{name}

HTTPcURLJavaScriptPython

PATCH /v1/tenant-data-conn-configs/{name} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "type": "text",
  "configs": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "message": "text"
}

Delete Tenant Data Connection

Delete Tenant Data Conn

delete

DELETE one data‑connection config by name for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

namestringRequired

Header parameters

correlation-idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/v1/tenant-data-conn-configs/{name}

HTTPcURLJavaScriptPython

DELETE /v1/tenant-data-conn-configs/{name} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "message": "text"
}

Users

Get Users

Get list of users

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Query parameters

roleany ofOptional

Filter users by role

string · enumOptionalPossible values:

or

nullOptional

Header parameters

correlation-idstringRequired

Responses

200

List of users retrieved successfully

application/json

400

Bad Request

422

Validation Error

application/json

500

Internal server error

get

/v1/users

HTTPcURLJavaScriptPython

GET /v1/users HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "users": [
    {
      "user_name": "text",
      "email_id": "text",
      "tenant_id": "text",
      "tenant_name": "text",
      "role": "CANSO_ADMIN",
      "status": "ACTIVE"
    }
  ]
}

Tenant Data ET Configs

Create Tenant Data ET

Create Tenant Data Et

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Header parameters

correlation-idstringRequired

Body

application/json

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/tenant-data-et-configs

HTTPcURLJavaScriptPython

POST /v1/tenant-data-et-configs HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "data_ets": [
    {
      "unit_name": "text",
      "configs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

{
  "message": "text"
}

Update Tenant Data ET

Update Tenant Data Et

patch

Update data ET config by unit_name for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

unit_namestringRequired

Header parameters

correlation-idstringRequired

Body

application/json

Responses

200

Successful Response

application/json

422

Validation Error

application/json

patch

/v1/tenant-data-et-configs/{unit_name}

HTTPcURLJavaScriptPython

PATCH /v1/tenant-data-et-configs/{unit_name} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "configs": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "message": "text"
}

Delete Tenant Data ET

Delete Tenant Data Conn

delete

DELETE one data ET config by unit_name for the current tenant.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

unit_namestringRequired

Header parameters

correlation-idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/v1/tenant-data-et-configs/{unit_name}

HTTPcURLJavaScriptPython

DELETE /v1/tenant-data-et-configs/{unit_name} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
correlation-id: text
Accept: */*

{
  "message": "text"
}