OpenAPI JSONMarkdown Docs

OpenAPI Explorer

Auto-generated OpenAPI definition for all enabled modules.

Default server: https://walix-demo.dainamite.com/api

Authentication & Accounts

Showing 20 of 36 endpoints
GET/auth/admin/nav
Auth required

Resolve backend chrome bootstrap payload

Returns the backend chrome payload available to the authenticated administrator after applying scope, RBAC, role defaults, and personal sidebar preferences.

Responses

200Backend chrome payload
Content-Type: application/json
{
  "brand": null,
  "groups": [
    {
      "name": "string",
      "items": [
        {
          "href": "string",
          "title": "string"
        }
      ]
    }
  ],
  "settingsSections": [
    {
      "id": "string",
      "label": "string",
      "items": [
        {
          "id": "string",
          "label": "string",
          "href": "string"
        }
      ]
    }
  ],
  "settingsPathPrefixes": [
    "string"
  ],
  "profileSections": [
    {
      "id": "string",
      "label": "string",
      "items": [
        {
          "id": "string",
          "label": "string",
          "href": "string"
        }
      ]
    }
  ],
  "profilePathPrefixes": [
    "string"
  ],
  "grantedFeatures": [
    "string"
  ],
  "roles": [
    "string"
  ],
  "currentOrganization": null
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/admin/nav" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/auth/autologin

Auto sign-in using env-configured demo credentials

When OM_AUTOLOGIN_EMAIL / OM_AUTOLOGIN_PASSWORD are configured, signs the visitor in with those credentials and redirects into the app. Intended for single-tenant demo instances only. Falls back to the login page when disabled or misconfigured.

Responses

200Success response
Content-Type: application/json
"string"
307Redirect into the app (or to /login on failure)
Content-Type: text/html
string

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/autologin" \
  -H "Accept: application/json"
POST/auth/feature-check
Auth required

Check feature grants for the current user

Evaluates which of the requested features are available to the signed-in user within the active tenant / organization context.

Request body (application/json)

{
  "features": [
    "string"
  ]
}

Responses

200Evaluation result
Content-Type: application/json
{
  "ok": true,
  "granted": [
    "string"
  ],
  "userId": "string"
}
400Invalid request — features array missing, too large, or contains invalid entries
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/feature-check" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"features\": [
    \"string\"
  ]
}"
GET/auth/features
Auth required

List declared feature flags

Returns all static features contributed by the enabled modules along with their module source.

Responses

200Aggregated feature catalog
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "title": "string",
      "module": "string"
    }
  ],
  "modules": [
    {
      "id": "string",
      "title": "string"
    }
  ]
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/features" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/auth/locale

Set locale and redirect

Stores the selected locale in a cookie and redirects to a safe local path.

Parameters

NameInRequiredSchemaDescription
localequeryYesanyA locale code this tenant serves — one of the `servable` entries returned by `GET /api/translations/locales`. Codes are canonicalized (`de-AT` → `de`).
redirectqueryNoany—

Responses

200Success response
Content-Type: application/json
"string"
302Locale cookie set and request redirected
Content-Type: application/json
"string"
400Invalid locale
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/locale?locale=string" \
  -H "Accept: application/json"
POST/auth/locale

Set locale

Stores the selected locale in a cookie and returns a JSON success response.

Request body (application/json)

{
  "locale": "string"
}

Responses

200Locale cookie set
Content-Type: application/json
{
  "ok": true
}
400Invalid locale or malformed request body
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/locale" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{
  \"locale\": \"string\"
}"
POST/auth/login

Authenticate user credentials

Validates the submitted credentials and issues a bearer token cookie for subsequent API calls.

Request body (application/x-www-form-urlencoded)

email=user%40example.com&password=string

Responses

200Authentication succeeded
Content-Type: application/json
{
  "ok": true,
  "token": "string",
  "redirect": null
}
400Validation failed
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}
401Invalid credentials
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}
403User lacks required role
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}
429Too many login attempts
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/login" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "email=user%40example.com&password=string"
POST/auth/logout
Auth required

Invalidate session and redirect

Clears authentication cookies and redirects the browser to the login page.

Responses

201Success response
Content-Type: application/json
"string"
302Redirect to login after successful logout
Content-Type: text/html
string

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/logout" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/auth/profile
Auth required

Get current profile

Returns the email address, display name, and roles for the signed-in user. The display name is null when unset.

Responses

200Profile payload
Content-Type: application/json
{
  "email": "user@example.com",
  "name": null,
  "roles": [
    "string"
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404User not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/profile" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/auth/profile
Auth required

Update current profile

Updates the email address or password for the signed-in user.

Request body (application/json)

{}

Responses

200Profile updated
Content-Type: application/json
{
  "ok": true,
  "email": "user@example.com"
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/auth/profile" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
POST/auth/reset

Send reset email

Requests a password reset email for the given account. The endpoint always returns `ok: true` to avoid leaking account existence.

Request body (application/x-www-form-urlencoded)

email=user%40example.com

Responses

200Reset email dispatched (or ignored for unknown accounts)
Content-Type: application/json
{
  "ok": true
}
400Invalid request origin
Content-Type: application/json
{
  "error": "string"
}
429Too many password reset requests
Content-Type: application/json
{
  "error": "string"
}
500Password reset email origin is not configured
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/reset" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "email=user%40example.com"
POST/auth/reset/confirm

Complete password reset

Validates the reset token and updates the user password. The returned `redirect` carries the resolved user's tenant as a navigation hint (`/login?tenant=...`) so a tenant-bound user lands on the tenant login entry; tenantless users get `/login`.

Request body (application/x-www-form-urlencoded)

token=string&password=string

Responses

200Password reset succeeded
Content-Type: application/json
{
  "ok": true,
  "redirect": "string"
}
400Invalid token or payload
Content-Type: application/json
{
  "ok": false,
  "error": "string"
}
429Too many reset confirmation attempts
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/reset/confirm" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=string&password=string"
POST/auth/reset/validate

Check whether a password reset token is still usable

Reports whether a reset token exists, is unused, and has not expired, so the reset page can render a terminal state instead of a form the token can never submit. The token is never consumed and the response never distinguishes unknown, used, and expired tokens.

Request body (application/x-www-form-urlencoded)

token=string

Responses

200Token state resolved
Content-Type: application/json
{
  "ok": true,
  "valid": true
}
429Too many token validation attempts
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/reset/validate" \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=string"
GET/auth/roles
Auth required

List roles

Returns available roles within the current tenant. Super administrators receive visibility across tenants.

Parameters

NameInRequiredSchemaDescription
idqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
tenantIdqueryNoany—

Responses

200Role collection
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "usersCount": 1,
      "tenantId": null,
      "tenantName": null,
      "updatedAt": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/roles?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/auth/roles
Auth required

Create role

Creates a new role anchored to the caller's tenant. Non-superadmins cannot target another tenant; supplying a foreign `tenantId` is rejected.

Request body (application/json)

{
  "name": "string"
}

Responses

201Role created
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/auth/roles" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"name\": \"string\"
}"
PUT/auth/roles
Auth required

Update role

Updates mutable fields on an existing role.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Role updated
Content-Type: application/json
{
  "ok": true
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Role not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/auth/roles" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/auth/roles
Auth required

Delete role

Deletes a role by identifier. Fails when users remain assigned.

Parameters

NameInRequiredSchemaDescription
idqueryYesanyRole identifier

Responses

200Role deleted
Content-Type: application/json
{
  "ok": true
}
400Role cannot be deleted
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Role not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/auth/roles?id=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/auth/roles/acl
Auth required

Fetch role ACL

Returns the feature and organization assignments associated with a role within the current tenant.

Parameters

NameInRequiredSchemaDescription
roleIdqueryYesany—
tenantIdqueryNoany—

Responses

200Role ACL entry
Content-Type: application/json
{
  "isSuperAdmin": true,
  "features": [
    "string"
  ],
  "organizations": null,
  "updatedAt": null
}
400Invalid role id
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Role not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/roles/acl?roleId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/auth/roles/acl
Auth required

Update role ACL

Replaces the feature list, super admin flag, and optional organization assignments for a role.

Request body (application/json)

{
  "roleId": "00000000-0000-4000-8000-000000000000",
  "organizations": null
}

Responses

200Role ACL updated
Content-Type: application/json
{
  "ok": true,
  "sanitized": true
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Insufficient privileges to modify ACL
Content-Type: application/json
{
  "error": "string"
}
404Role not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/auth/roles/acl" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"roleId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizations\": null
}"
GET/auth/session/refresh

Refresh auth cookie from session token (browser)

Exchanges an existing `session_token` cookie for a fresh JWT auth cookie and redirects the browser.

Parameters

NameInRequiredSchemaDescription
redirectqueryNoanyAbsolute or relative URL to redirect after refresh

Responses

200Success response
Content-Type: application/json
"string"
302Redirect to target location when session is valid
Content-Type: text/html
string

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/session/refresh" \
  -H "Accept: application/json"

API Keys

Showing 3 of 3 endpoints
GET/api_keys/keys
Auth required

List API keys

Returns paginated API keys visible to the current user, including per-key role assignments and organization context.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—

Responses

200Collection of API keys
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "name": "string",
      "description": null,
      "keyPrefix": "string",
      "organizationId": null,
      "organizationName": null,
      "createdAt": "string",
      "lastUsedAt": null,
      "expiresAt": null,
      "roles": [
        {
          "id": "string",
          "name": null
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}
400Tenant context missing
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden by organization scope
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/api_keys/keys" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/api_keys/keys
Auth required

Create API key

Creates a new API key, returning the one-time secret value together with the generated key prefix and scope details.

Request body (application/json)

{
  "name": "string",
  "description": null,
  "tenantId": null,
  "organizationId": null,
  "roles": [],
  "expiresAt": null
}

Responses

201API key created successfully
Content-Type: application/json
{
  "id": "string",
  "name": "string",
  "keyPrefix": "string",
  "tenantId": null,
  "organizationId": null,
  "roles": [
    {
      "id": "string",
      "name": null
    }
  ]
}
400Invalid payload or missing tenant context
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Organization outside allowed scope
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/api_keys/keys" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"name\": \"string\",
  \"description\": null,
  \"tenantId\": null,
  \"organizationId\": null,
  \"roles\": [],
  \"expiresAt\": null
}"
DELETE/api_keys/keys
Auth required

Delete API key

Removes an API key by identifier. The key must belong to the current tenant and fall within the requester organization scope.

Parameters

NameInRequiredSchemaDescription
idqueryYesanyAPI key identifier to delete

Responses

200Key deleted successfully
Content-Type: application/json
{
  "success": true
}
400Missing or invalid identifier
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Organization outside allowed scope
Content-Type: application/json
{
  "error": "string"
}
404Key not found within scope
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/api_keys/keys?id=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Directory (Tenants & Organizations)

Showing 2 of 2 endpoints
GET/directory/organizations/lookup

Public organization lookup by slug

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/organizations/lookup" \
  -H "Accept: application/json"
GET/directory/tenants/lookup

Public tenant lookup

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/tenants/lookup" \
  -H "Accept: application/json"

API Documentation

Showing 1 of 1 endpoints
GET/version

Deployed Open Mercato version

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/version" \
  -H "Accept: application/json"

Audit & Action Logs

Showing 5 of 5 endpoints
GET/audit_logs/audit-logs/access
Auth required

Retrieve access logs

Fetches paginated access audit logs scoped to the authenticated user. Tenant administrators can optionally expand the search to other actors or organizations.

Parameters

NameInRequiredSchemaDescription
organizationIdqueryNoanyLimit results to a specific organization
actorUserIdqueryNoanyFilter by actor user id (tenant administrators only)
resourceKindqueryNoanyRestrict to a resource kind such as `order` or `product`
accessTypequeryNoanyAccess type filter, e.g. `read` or `export`
pagequeryNoanyPage number (default 1)
pageSizequeryNoanyPage size (default 50)
limitqueryNoanyExplicit maximum number of records when paginating manually
beforequeryNoanyReturn logs created before this ISO-8601 timestamp
afterqueryNoanyReturn logs created after this ISO-8601 timestamp

Responses

200Access logs returned successfully
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "resourceKind": "string",
      "resourceId": "string",
      "accessType": "string",
      "actorUserId": null,
      "actorUserName": null,
      "tenantId": null,
      "tenantName": null,
      "organizationId": null,
      "organizationName": null,
      "fields": [
        "string"
      ],
      "context": null,
      "createdAt": "string"
    }
  ],
  "canViewTenant": true,
  "page": 1,
  "pageSize": 1,
  "total": 1,
  "totalPages": 1
}
400Invalid filters supplied
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Caller has no resolved tenant scope and is not a superadmin
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/audit_logs/audit-logs/access" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/audit_logs/audit-logs/actions
Auth required

Fetch action logs

Returns recent action audit log entries. Tenant administrators can widen the scope to other actors or organizations, and callers can optionally restrict results to undoable actions.

Parameters

NameInRequiredSchemaDescription
organizationIdqueryNoanyLimit results to a specific organization
actorUserIdqueryNoanyFilter logs created by specific actor IDs (tenant administrators only). Accepts a single UUID or a comma-separated UUID list.
resourceKindqueryNoanyFilter by resource kind (e.g., "order", "product")
resourceIdqueryNoanyFilter by resource ID (UUID of the specific record)
actionTypequeryNoanyFilter by action type (`create`, `edit`, `delete`, `assign`). Accepts a single value or a comma-separated list.
fieldNamequeryNoanyFilter to entries where the given field changed. Accepts a single field name or a comma-separated list.
includeRelatedqueryNoanyWhen `true`, also returns changes to child entities linked via parentResourceKind/parentResourceId
includeTotalqueryNoanyWhen `true`, the response includes the filtered total count.
undoableOnlyqueryNoanyWhen `true`, only undoable actions are returned
limitqueryNoanyMaximum number of records to return (default 50, max 1000)
offsetqueryNoanyZero-based record offset for pagination (legacy — prefer page/pageSize)
pagequeryNoanyPage number (default 1)
pageSizequeryNoanyPage size (default 50, max 200)
sortFieldqueryNoanySort field: `createdAt`, `user`, `action`, `field`, or `source`.
sortDirqueryNoanySort direction: `asc` or `desc`.
beforequeryNoanyReturn actions created before this ISO-8601 timestamp
afterqueryNoanyReturn actions created after this ISO-8601 timestamp

Responses

200Action logs retrieved successfully
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "commandId": "string",
      "actionLabel": null,
      "executionState": "done",
      "actorUserId": null,
      "actorUserName": null,
      "tenantId": null,
      "tenantName": null,
      "organizationId": null,
      "organizationName": null,
      "resourceKind": null,
      "resourceId": null,
      "parentResourceKind": null,
      "parentResourceId": null,
      "undoToken": null,
      "createdAt": "string",
      "updatedAt": "string",
      "snapshotBefore": null,
      "snapshotAfter": null,
      "changes": null,
      "context": null
    }
  ],
  "canViewTenant": true,
  "page": 1,
  "pageSize": 1,
  "total": 1,
  "totalPages": 1
}
400Invalid filter values
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Caller has no resolved tenant scope and is not a superadmin
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/audit_logs/audit-logs/actions?includeRelated=false&includeTotal=false&undoableOnly=false" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/audit_logs/audit-logs/actions/export
Auth required

Export action logs as CSV

Returns a CSV attachment containing filtered action audit log entries. Tenant administrators can widen the scope to other actors or organizations.

Parameters

NameInRequiredSchemaDescription
organizationIdqueryNoanyLimit results to a specific organization
actorUserIdqueryNoanyFilter logs created by specific actor IDs (tenant administrators only). Accepts a single UUID or a comma-separated UUID list.
resourceKindqueryNoanyFilter by resource kind (e.g., "order", "product")
resourceIdqueryNoanyFilter by resource ID (UUID of the specific record)
actionTypequeryNoanyFilter by action type (`create`, `edit`, `delete`, `assign`). Accepts a single value or a comma-separated list.
fieldNamequeryNoanyFilter to entries where the given field changed. Accepts a single field name or a comma-separated list.
includeRelatedqueryNoanyWhen `true`, also returns changes to child entities linked via parentResourceKind/parentResourceId
undoableOnlyqueryNoanyWhen `true`, only undoable actions are returned
limitqueryNoanyMaximum number of records to export (default 1000, capped at 1000)
sortFieldqueryNoanySort field: `createdAt`, `user`, `action`, `field`, or `source`.
sortDirqueryNoanySort direction: `asc` or `desc`.
beforequeryNoanyReturn actions created before this ISO-8601 timestamp
afterqueryNoanyReturn actions created after this ISO-8601 timestamp

Responses

200CSV export generated successfully
Content-Type: application/json
{
  "file": "csv"
}
400Invalid filter values
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Caller has no resolved tenant scope and is not a superadmin
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/audit_logs/audit-logs/actions/export?includeRelated=false&undoableOnly=false" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/audit_logs/audit-logs/actions/redo
Auth required

Redo by action log id

Redoes the latest undone command owned by the caller. Requires the action to still be eligible for redo within tenant and organization scope.

Request body (application/json)

{
  "logId": "string"
}

Responses

200Redo executed successfully
Content-Type: application/json
{
  "ok": true,
  "logId": null,
  "undoToken": null
}
400Log not eligible for redo
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Redo blocked by scope checks
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/audit_logs/audit-logs/actions/redo" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"logId\": \"string\"
}"
POST/audit_logs/audit-logs/actions/undo
Auth required

Undo action by token

Replays the undo handler registered for a command. The provided undo token must match the latest undoable log entry accessible to the caller.

Request body (application/json)

{
  "undoToken": "string"
}

Responses

200Undo applied successfully
Content-Type: application/json
{
  "ok": true,
  "logId": "string"
}
400Invalid or unavailable undo token
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Undo blocked by organization or tenant scope
Content-Type: application/json
{
  "error": "string"
}
422Undo deliberately blocked by a beforeUndo command interceptor. The interceptor chooses the status (any 4xx/5xx) and may replace the body.
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/audit_logs/audit-logs/actions/undo" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"undoToken\": \"string\"
}"

Notifications

Showing 20 of 22 endpoints
GET/notifications
Auth required

List notifications

Returns a paginated collection of notifications.

Parameters

NameInRequiredSchemaDescription
statusqueryNoany—
typequeryNoany—
severityqueryNoany—
sourceEntityTypequeryNoany—
sourceEntityIdqueryNoany—
sincequeryNoany—
pagequeryNoany—
pageSizequeryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated notifications
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "type": "string",
      "title": "string",
      "body": null,
      "titleKey": null,
      "bodyKey": null,
      "titleVariables": null,
      "bodyVariables": null,
      "icon": null,
      "severity": "string",
      "status": "string",
      "actions": [
        {
          "id": "string",
          "label": "string"
        }
      ],
      "sourceModule": null,
      "sourceEntityType": null,
      "sourceEntityId": null,
      "linkHref": null,
      "createdAt": "string",
      "readAt": null,
      "actionTaken": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}
403Request could not be resolved to a tenant scope (code: tenant_scope_required)
Content-Type: application/json
{
  "error": "string",
  "code": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications?page=1&pageSize=20" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/notifications
Auth required

Create notification

Creates a notification for a user.

Request body (application/json)

{
  "type": "string",
  "severity": "info",
  "recipientUserId": "00000000-0000-4000-8000-000000000000"
}

Responses

201Notification created
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"type\": \"string\",
  \"severity\": \"info\",
  \"recipientUserId\": \"00000000-0000-4000-8000-000000000000\"
}"
POST/notifications/{id}/action
Auth required

POST /notifications/{id}/action

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications/:id/action" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/{id}/dismiss
Auth required

PUT /notifications/{id}/dismiss

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/:id/dismiss" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/{id}/read
Auth required

PUT /notifications/{id}/read

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/:id/read" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/{id}/restore
Auth required

PUT /notifications/{id}/restore

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/:id/restore" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/notifications/admin/preferences
Auth required

GET /notifications/admin/preferences

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications/admin/preferences" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/admin/preferences
Auth required

PUT /notifications/admin/preferences

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/admin/preferences" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/notifications/batch
Auth required

POST /notifications/batch

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications/batch" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/notifications/channels
Auth required

GET /notifications/channels

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/notifications/feature
Auth required

POST /notifications/feature

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications/feature" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/mark-all-read
Auth required

PUT /notifications/mark-all-read

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/mark-all-read" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/notifications/preferences
Auth required

GET /notifications/preferences

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications/preferences" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/preferences
Auth required

PUT /notifications/preferences

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/preferences" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/notifications/role
Auth required

POST /notifications/role

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications/role" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/notifications/settings
Auth required

GET /notifications/settings

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications/settings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/notifications/settings
Auth required

POST /notifications/settings

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/notifications/settings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/notifications/types
Auth required

GET /notifications/types

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/notifications/types" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/notifications/types
Auth required

PATCH /notifications/types

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/notifications/types" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/notifications/types/{id}/channels/{channel}
Auth required

PUT /notifications/types/{id}/channels/{channel}

Parameters

NameInRequiredSchemaDescription
idpathYesany—
channelpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/notifications/types/:id/channels/:channel" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Events

Showing 2 of 2 endpoints
GET/events
Auth required

List declared events

Returns every declared event, including its declared payloadSchema when the module (or the generated CRUD default) provides one. Filters: category, module, excludeTriggerExcluded (default true).

Responses

200Declared events
Content-Type: application/json
{
  "data": [
    {
      "id": "string",
      "label": "string"
    }
  ],
  "total": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/events" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/events/stream
Auth required

GET /events/stream

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/events/stream" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Search

Showing 15 of 15 endpoints
GET/search/embeddings
Auth required

Get embeddings configuration

Returns current embedding provider and model configuration.

Responses

200Embeddings settings
Content-Type: application/json
{
  "settings": {
    "openaiConfigured": true,
    "autoIndexingEnabled": true,
    "autoIndexingLocked": true,
    "lockReason": null,
    "embeddingConfig": null,
    "configuredProviders": [
      "openai"
    ],
    "indexedDimension": null,
    "reindexRequired": true,
    "documentCount": null
  }
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/embeddings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/search/embeddings
Auth required

Update embeddings configuration

Updates the embedding provider and model settings.

Request body (application/json)

{}

Responses

200Updated settings
Content-Type: application/json
{
  "settings": {
    "openaiConfigured": true,
    "autoIndexingEnabled": true,
    "autoIndexingLocked": true,
    "lockReason": null,
    "embeddingConfig": null,
    "configuredProviders": [
      "openai"
    ],
    "indexedDimension": null,
    "reindexRequired": true,
    "documentCount": null
  }
}
400Invalid request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
409Auto-indexing disabled via environment
Content-Type: application/json
{
  "error": "string"
}
500Update failed
Content-Type: application/json
{
  "error": "string"
}
503Configuration service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/embeddings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
POST/search/embeddings/reindex
Auth required

Trigger vector reindex

Starts a vector embedding reindex operation.

Request body (application/json)

{}

Responses

200Reindex result
Content-Type: application/json
{
  "ok": true
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
409Reindex already in progress
Content-Type: application/json
{
  "error": "string",
  "lock": {
    "type": "fulltext",
    "action": "string",
    "startedAt": "string",
    "elapsedMinutes": 1,
    "processedCount": null,
    "totalCount": null
  }
}
500Reindex failed
Content-Type: application/json
{
  "error": "string"
}
503Search indexer unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/embeddings/reindex" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
POST/search/embeddings/reindex/cancel
Auth required

Cancel vector reindex

Cancels an in-progress vector reindex operation.

Responses

200Cancel result
Content-Type: application/json
{
  "ok": true,
  "jobsRemoved": 1
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/embeddings/reindex/cancel" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/search/index
Auth required

List vector index entries

Returns paginated list of entries in the vector search index.

Parameters

NameInRequiredSchemaDescription
entityIdqueryNoanyFilter by entity ID (e.g., "customers:customer_person_profile", "catalog:catalog_product")
limitqueryNoanyMaximum entries to return (default: 50, max: 200)
offsetqueryNoanyOffset for pagination (default: 0)

Responses

200Index entries
Content-Type: application/json
{
  "entries": [
    {
      "id": "string",
      "entityId": "string",
      "recordId": "string",
      "tenantId": "string",
      "organizationId": null
    }
  ],
  "limit": 1,
  "offset": 1
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to fetch index
Content-Type: application/json
{
  "error": "string"
}
503Vector strategy unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/index" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/search/index
Auth required

Purge vector index

Purges entries from the vector search index. Requires confirmAll=true when purging all entities.

Parameters

NameInRequiredSchemaDescription
entityIdqueryNoanySpecific entity ID to purge (e.g., "customers:customer_person_profile", "catalog:catalog_product")
confirmAllqueryNoanyRequired when purging all entities

Responses

200Purge result
Content-Type: application/json
{
  "ok": true
}
400Missing confirmAll parameter
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Purge failed
Content-Type: application/json
{
  "error": "string"
}
503Search indexer unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/search/index" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/search/reindex
Auth required

Trigger fulltext reindex

Starts a fulltext (Meilisearch) reindex operation. Can clear, recreate, or fully reindex.

Request body (application/json)

{}

Responses

200Reindex result
Content-Type: application/json
{
  "ok": true,
  "action": "clear",
  "entityId": null
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
409Reindex already in progress
Content-Type: application/json
{
  "error": "string",
  "lock": {
    "type": "fulltext",
    "action": "string",
    "startedAt": "string",
    "elapsedMinutes": 1,
    "processedCount": null,
    "totalCount": null
  }
}
500Reindex failed
Content-Type: application/json
{
  "error": "string"
}
503Search service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/reindex" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
POST/search/reindex/cancel
Auth required

Cancel fulltext reindex

Cancels an in-progress fulltext reindex operation.

Responses

200Cancel result
Content-Type: application/json
{
  "ok": true,
  "jobsRemoved": 1
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/reindex/cancel" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/search/search/global
Auth required

Global search (Cmd+K)

Performs a global search using saved tenant strategies. Does NOT accept strategies from URL.

Parameters

NameInRequiredSchemaDescription
qqueryYesanySearch query (required)
limitqueryNoanyMaximum results to return (default: 50, max: 100)
entityTypesqueryNoanyComma-separated entity types to filter results (e.g., "customers:customer_person_profile,catalog:catalog_product,sales:sales_order")

Responses

200Search results
Content-Type: application/json
{
  "results": [
    {
      "entityId": "string",
      "recordId": "string",
      "score": 1,
      "source": "fulltext"
    }
  ],
  "strategiesUsed": [
    "fulltext"
  ],
  "strategiesEnabled": [
    "fulltext"
  ],
  "timing": 1,
  "query": "string",
  "limit": 1
}
400Missing query parameter
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Search failed
Content-Type: application/json
{
  "error": "string"
}
503Search service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/search/global?q=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/search/settings
Auth required

Get search settings and status

Returns search module configuration, available strategies, and reindex lock status.

Responses

200Search settings
Content-Type: application/json
{
  "settings": {
    "strategies": [
      {
        "id": "string",
        "name": "string",
        "priority": 1,
        "available": true
      }
    ],
    "fulltextConfigured": true,
    "fulltextStats": null,
    "vectorConfigured": true,
    "tokensEnabled": true,
    "defaultStrategies": [
      "string"
    ],
    "reindexLock": null,
    "fulltextReindexLock": null,
    "vectorReindexLock": null
  }
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/settings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/search/settings/fulltext
Auth required

Get fulltext search configuration

Returns Meilisearch configuration status and index statistics.

Responses

200Fulltext settings
Content-Type: application/json
{
  "driver": null,
  "configured": true,
  "envVars": {
    "MEILISEARCH_HOST": {
      "set": true,
      "hint": "string"
    },
    "MEILISEARCH_API_KEY": {
      "set": true,
      "hint": "string"
    }
  },
  "optionalEnvVars": {
    "MEILISEARCH_INDEX_PREFIX": {
      "set": true,
      "hint": "string"
    },
    "SEARCH_EXCLUDE_ENCRYPTED_FIELDS": {
      "set": true,
      "hint": "string"
    }
  }
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/settings/fulltext" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/search/settings/global-search
Auth required

Update global search strategies

Sets which strategies are enabled for Cmd+K global search.

Request body (application/json)

{
  "enabledStrategies": [
    "fulltext"
  ]
}

Responses

200Updated settings
Content-Type: application/json
{
  "ok": true,
  "enabledStrategies": [
    "fulltext"
  ]
}
400Invalid request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/search/settings/global-search" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"enabledStrategies\": [
    \"fulltext\"
  ]
}"
GET/search/settings/vector-store
Auth required

Get vector store configuration

Returns vector store configuration status.

Responses

200Vector store settings
Content-Type: application/json
{
  "currentDriver": "pgvector",
  "configured": true,
  "drivers": [
    {
      "id": "pgvector",
      "name": "string",
      "configured": true,
      "implemented": true,
      "available": null,
      "unavailableReason": null,
      "envVars": [
        {
          "name": "string",
          "set": true,
          "hint": "string"
        }
      ]
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/search/settings/vector-store" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Attachments

Showing 14 of 14 endpoints
GET/attachments
Auth required

List attachments for a record

Returns uploaded attachments for the given entity record, ordered by newest first.

Parameters

NameInRequiredSchemaDescription
entityIdqueryYesanyEntity identifier that owns the attachments
recordIdqueryYesanyRecord identifier within the entity
pagequeryNoany—
pageSizequeryNoany—

Responses

200Attachments found for the record
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "url": "string",
      "fileName": "string",
      "fileSize": 1,
      "createdAt": "string",
      "mimeType": null,
      "content": null
    }
  ]
}
400Missing entity or record identifiers
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments?entityId=string&recordId=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/attachments
Auth required

Upload attachment

Uploads a new attachment using multipart form-data and stores metadata for later retrieval.

Request body (multipart/form-data)

entityId=string
recordId=string
file=string

Responses

200Attachment stored successfully
Content-Type: application/json
{
  "ok": true,
  "item": {
    "id": "string",
    "url": "string",
    "fileName": "string",
    "fileSize": 1,
    "content": null
  }
}
400Payload validation error
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Attachment violates field constraints
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/attachments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: multipart/form-data" \
  -d "{
  \"entityId\": \"string\",
  \"recordId\": \"string\",
  \"file\": \"string\"
}"
DELETE/attachments
Auth required

Delete attachment

Removes an uploaded attachment and deletes the stored asset.

Parameters

NameInRequiredSchemaDescription
idqueryYesany—

Responses

200Attachment deleted
Content-Type: application/json
{
  "ok": true
}
400Missing attachment identifier
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Attachment not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/attachments?id=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/attachments/file/{id}

Download or serve attachment file

Returns the raw file content for an attachment. Path parameter: {id} - Attachment UUID. Query parameter: ?download=1 - Force file download with Content-Disposition header. Access control is enforced based on partition settings.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200File content with appropriate MIME type
Content-Type: application/json
"string"
400Missing attachment ID
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized - authentication required for private partitions
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - insufficient permissions
Content-Type: application/json
{
  "error": "string"
}
404Attachment or file not found
Content-Type: application/json
{
  "error": "string"
}
500Partition misconfigured
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments/file/:id" \
  -H "Accept: application/json"
GET/attachments/image/{id}/{slug}

Serve image with optional resizing

Returns an image attachment with optional on-the-fly resizing and cropping. Resized images are cached for performance. Only works with image MIME types. Path parameter: {id} - Attachment UUID. Query parameters: ?width=N (1-4000 pixels), ?height=N (1-4000 pixels), ?cropType=cover|contain (resize behavior).

Parameters

NameInRequiredSchemaDescription
idpathYesany—
slugpathNoany—

Responses

200Binary image content (Content-Type: image/jpeg, image/png, etc.)
Content-Type: application/json
"string"
400Invalid parameters, missing ID, or non-image attachment
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized - authentication required for private partitions
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - insufficient permissions
Content-Type: application/json
{
  "error": "string"
}
404Image not found
Content-Type: application/json
{
  "error": "string"
}
500Partition misconfigured or image rendering failed
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments/image/:id/:slug" \
  -H "Accept: application/json"
GET/attachments/library
Auth required

List attachments

Returns paginated list of attachments with optional filtering by search term, partition, and tags. Includes available tags and partitions.

Parameters

NameInRequiredSchemaDescription
pagequeryNoanyPage number for pagination
pageSizequeryNoanyNumber of items per page (max 100)
searchqueryNoanySearch by file name (case-insensitive)
partitionqueryNoanyFilter by partition code
tagsqueryNoanyFilter by tags (comma-separated)
sortFieldqueryNoanyField to sort by
sortDirqueryNoanySort direction

Responses

200Attachments list with pagination and metadata
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "fileName": "string",
      "fileSize": 1,
      "mimeType": "string",
      "partitionCode": "string",
      "partitionTitle": null,
      "url": null,
      "createdAt": "string",
      "tags": [
        "string"
      ],
      "assignments": [],
      "content": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1,
  "availableTags": [
    "string"
  ],
  "partitions": [
    {
      "code": "string",
      "title": "string",
      "description": null,
      "isPublic": true
    }
  ]
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments/library?page=1&pageSize=25" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/attachments/library/{id}
Auth required

Get attachment details

Returns complete details of an attachment including metadata, tags, assignments, and custom fields.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Attachment details
Content-Type: application/json
{
  "item": {
    "id": "00000000-0000-4000-8000-000000000000",
    "fileName": "string",
    "fileSize": 1,
    "mimeType": "string",
    "partitionCode": "string",
    "partitionTitle": null,
    "tags": [
      "string"
    ],
    "assignments": [],
    "content": null,
    "customFields": null
  }
}
400Invalid attachment ID
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Attachment not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments/library/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/attachments/library/{id}
Auth required

Update attachment metadata

Updates attachment tags, assignments, and custom fields. Emits CRUD side effects for indexing and events.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{}

Responses

200Attachment updated successfully
Content-Type: application/json
{
  "ok": true
}
400Invalid payload or attachment ID
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Attachment not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to save attributes
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/attachments/library/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
DELETE/attachments/library/{id}
Auth required

Delete attachment

Permanently deletes an attachment file from storage and database. Emits CRUD side effects.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Attachment deleted successfully
Content-Type: application/json
{
  "ok": true
}
400Invalid attachment ID
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Attachment not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/attachments/library/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/attachments/partitions
Auth required

List all attachment partitions

Returns all configured attachment partitions with storage settings, OCR configuration, and access control settings.

Responses

200List of partitions
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "code": "string",
      "title": "string",
      "description": null,
      "isPublic": true,
      "requiresOcr": true,
      "ocrModel": null,
      "configJson": null,
      "createdAt": null,
      "updatedAt": null,
      "envKey": "string"
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/attachments/partitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/attachments/partitions
Auth required

Create new partition

Creates a new attachment partition with specified storage and OCR settings. Requires unique partition code.

Request body (application/json)

{
  "code": "string",
  "title": "string",
  "description": null,
  "ocrModel": null,
  "storageDriver": "local",
  "configJson": null
}

Responses

201Partition created successfully
Content-Type: application/json
{
  "item": {
    "id": "00000000-0000-4000-8000-000000000000",
    "code": "string",
    "title": "string",
    "description": null,
    "isPublic": true,
    "requiresOcr": true,
    "ocrModel": null,
    "configJson": null,
    "createdAt": null,
    "updatedAt": null,
    "envKey": "string"
  }
}
400Invalid payload or partition code
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Partitions locked in demo mode
Content-Type: application/json
{
  "error": "string"
}
409Partition code already exists
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/attachments/partitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"title\": \"string\",
  \"description\": null,
  \"ocrModel\": null,
  \"storageDriver\": \"local\",
  \"configJson\": null
}"
PUT/attachments/partitions
Auth required

Update partition

Updates an existing partition. Partition code cannot be changed. Title, description, OCR settings, and access control can be modified.

Request body (application/json)

{
  "code": "string",
  "title": "string",
  "description": null,
  "ocrModel": null,
  "storageDriver": "local",
  "configJson": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Partition updated successfully
Content-Type: application/json
{
  "item": {
    "id": "00000000-0000-4000-8000-000000000000",
    "code": "string",
    "title": "string",
    "description": null,
    "isPublic": true,
    "requiresOcr": true,
    "ocrModel": null,
    "configJson": null,
    "createdAt": null,
    "updatedAt": null,
    "envKey": "string"
  }
}
400Invalid payload or code change attempt
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Partitions locked in demo mode
Content-Type: application/json
{
  "error": "string"
}
404Partition not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/attachments/partitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"title\": \"string\",
  \"description\": null,
  \"ocrModel\": null,
  \"storageDriver\": \"local\",
  \"configJson\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/attachments/partitions
Auth required

Delete partition

Deletes a partition. Default partitions cannot be deleted. Partitions with existing attachments cannot be deleted.

Responses

200Partition deleted successfully
Content-Type: application/json
{
  "ok": true
}
400Invalid ID or default partition deletion attempt
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Partitions locked in demo mode
Content-Type: application/json
{
  "error": "string"
}
404Partition not found
Content-Type: application/json
{
  "error": "string"
}
409Partition in use
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/attachments/partitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/attachments/transfer
Auth required

Transfer attachments to different record

Transfers one or more attachments from one record to another within the same entity type. Updates attachment assignments and metadata to reflect the new record.

Request body (application/json)

{
  "entityId": "string",
  "attachmentIds": [
    "00000000-0000-4000-8000-000000000000"
  ],
  "toRecordId": "string"
}

Responses

200Attachments transferred successfully
Content-Type: application/json
{
  "ok": true,
  "updated": 1
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Attachments not found
Content-Type: application/json
{
  "error": "string"
}
500Attachment model missing
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/attachments/transfer" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"attachmentIds\": [
    \"00000000-0000-4000-8000-000000000000\"
  ],
  \"toRecordId\": \"string\"
}"

Customer Relationship Management

Showing 2 of 2 endpoints
POST/customers/deals/bulk-update-owner
Auth required

Bulk reassign deal owner

Queues a background job that reassigns the listed deals to a new owner (or clears the owner when null).

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/deals/bulk-update-owner" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/customers/deals/bulk-update-stage
Auth required

Bulk update deal pipeline stage

Queues a background job that moves the listed deals to the same pipeline stage. Returns a progress job id to poll for completion.

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/deals/bulk-update-stage" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Messages

Showing 20 of 26 endpoints
GET/messages
Auth required

List messages

Parameters

NameInRequiredSchemaDescription
folderqueryNoany—
statusqueryNoany—
typequeryNoany—
visibilityqueryNoany—
sourceEntityTypequeryNoany—
sourceEntityIdqueryNoany—
externalEmailqueryNoany—
hasObjectsqueryNoany—
hasAttachmentsqueryNoany—
hasActionsqueryNoany—
senderIdqueryNoany—
searchqueryNoany—
sincequeryNoany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200Message list
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "type": "string",
      "visibility": null,
      "sourceEntityType": null,
      "sourceEntityId": null,
      "externalEmail": null,
      "externalName": null,
      "subject": "string",
      "bodyPreview": "string",
      "senderUserId": "00000000-0000-4000-8000-000000000000",
      "senderName": null,
      "senderEmail": null,
      "priority": "string",
      "status": "string",
      "hasObjects": true,
      "objectCount": 1,
      "hasAttachments": true,
      "attachmentCount": 1,
      "recipientCount": 1,
      "hasActions": true,
      "actionTaken": null,
      "sentAt": null,
      "readAt": null,
      "threadId": null
    }
  ],
  "page": 1,
  "pageSize": 1,
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/messages?folder=inbox&page=1&pageSize=20" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/messages
Auth required

Compose a message

Request body (application/json)

{
  "type": "default",
  "visibility": null,
  "recipients": [],
  "subject": "",
  "body": "",
  "bodyFormat": "text",
  "priority": "normal",
  "sendViaEmail": false,
  "isDraft": false
}

Responses

201Message created
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "threadId": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/messages" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"type\": \"default\",
  \"visibility\": null,
  \"recipients\": [],
  \"subject\": \"\",
  \"body\": \"\",
  \"bodyFormat\": \"text\",
  \"priority\": \"normal\",
  \"sendViaEmail\": false,
  \"isDraft\": false
}"
GET/messages/{id}
Auth required

Get message detail

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Message detail with actor-visible thread items only
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "updatedAt": null,
  "type": "string",
  "isDraft": true,
  "canEditDraft": true,
  "canArchive": true,
  "isArchived": true,
  "visibility": null,
  "sourceEntityType": null,
  "sourceEntityId": null,
  "externalEmail": null,
  "externalName": null,
  "typeDefinition": {
    "labelKey": "string",
    "icon": "string",
    "color": null,
    "allowReply": true,
    "allowForward": true,
    "ui": null
  },
  "threadId": null,
  "parentMessageId": null,
  "senderUserId": "00000000-0000-4000-8000-000000000000",
  "senderName": null,
  "senderEmail": null,
  "subject": "string",
  "body": "string",
  "bodyFormat": "text",
  "priority": "string",
  "sentAt": null,
  "actionData": null,
  "actionTaken": null,
  "actionTakenAt": null,
  "actionTakenByUserId": null,
  "recipients": [
    {
      "userId": "00000000-0000-4000-8000-000000000000",
      "type": "to",
      "status": "string",
      "readAt": null
    }
  ],
  "objects": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "entityModule": "string",
      "entityType": "string",
      "entityId": "00000000-0000-4000-8000-000000000000",
      "actionRequired": true,
      "actionType": null,
      "actionLabel": null,
      "snapshot": null,
      "preview": null
    }
  ],
  "thread": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "senderUserId": "00000000-0000-4000-8000-000000000000",
      "senderName": null,
      "senderEmail": null,
      "externalName": null,
      "externalEmail": null,
      "sourceEntityType": null,
      "body": "string",
      "sentAt": null
    }
  ],
  "isRead": true,
  "conversationArchived": true,
  "conversationAllUnread": true,
  "_channel": null,
  "_channelPayload": null,
  "_channelContact": null
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/messages/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/messages/{id}
Auth required

Update draft message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{
  "visibility": null
}

Responses

200Draft updated
Content-Type: application/json
{
  "ok": true
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}
409Only drafts can be edited, or the draft was modified concurrently (optimistic lock conflict)
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/messages/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"visibility\": null
}"
DELETE/messages/{id}
Auth required

Delete message for current sender/recipient context

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Message deleted
Content-Type: application/json
{
  "ok": true
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}
409Message was modified concurrently (optimistic lock conflict)
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/messages/{id}/actions/{actionId}
Auth required

Execute message action

Parameters

NameInRequiredSchemaDescription
idpathYesany—
actionIdpathYesany—

Request body (application/json)

"string"

Responses

200Action executed
Content-Type: application/json
{
  "ok": true,
  "actionId": "string"
}
403Access denied
Content-Type: application/json
"string"
404Action not found
Content-Type: application/json
"string"
409Action already taken, or the message was modified concurrently (optimistic lock conflict)
Content-Type: application/json
"string"
410Action expired
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/messages/:id/actions/:actionId" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/messages/{id}/archive
Auth required

Archive message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Message archived
Content-Type: application/json
{
  "ok": true
}
403Access denied or sender-only message cannot be archived
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/messages/:id/archive" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/messages/{id}/archive
Auth required

Unarchive message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Message unarchived
Content-Type: application/json
{
  "ok": true
}
403Access denied or sender-only message cannot be unarchived
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id/archive" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/messages/{id}/attachments
Auth required

List message attachments

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Attachments
Content-Type: application/json
{
  "attachments": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "fileName": "string",
      "fileSize": 1,
      "mimeType": "string",
      "url": "string"
    }
  ]
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/messages/:id/attachments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/messages/{id}/attachments
Auth required

Link attachments to draft message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{
  "attachmentIds": [
    "00000000-0000-4000-8000-000000000000"
  ]
}

Responses

200Attachments linked
Content-Type: application/json
{
  "ok": true
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}
409Only draft messages can be edited
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/messages/:id/attachments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"attachmentIds\": [
    \"00000000-0000-4000-8000-000000000000\"
  ]
}"
DELETE/messages/{id}/attachments
Auth required

Unlink attachments from draft message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{}

Responses

200Attachments unlinked
Content-Type: application/json
{
  "ok": true
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}
409Only draft messages can be edited
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id/attachments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
GET/messages/{id}/confirmation
Auth required

Read message confirmation status

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Confirmation status
Content-Type: application/json
{
  "messageId": "00000000-0000-4000-8000-000000000000",
  "confirmed": true,
  "confirmedAt": null,
  "confirmedByUserId": null
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/messages/:id/confirmation" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/messages/{id}/conversation
Auth required

Delete conversation for current actor

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Conversation deleted
Content-Type: application/json
{
  "ok": true,
  "affectedCount": 1
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id/conversation" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/messages/{id}/conversation/archive
Auth required

Archive conversation for current actor

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Conversation archived
Content-Type: application/json
{
  "ok": true,
  "affectedCount": 1
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/messages/:id/conversation/archive" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/messages/{id}/conversation/archive
Auth required

Unarchive conversation for current actor

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Conversation unarchived
Content-Type: application/json
{
  "ok": true,
  "affectedCount": 1
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id/conversation/archive" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/messages/{id}/conversation/read
Auth required

Mark entire conversation as read for current actor

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Conversation marked read
Content-Type: application/json
{
  "ok": true,
  "affectedCount": 1
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/messages/:id/conversation/read" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/messages/{id}/conversation/read
Auth required

Mark entire conversation as unread for current actor

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Conversation marked unread
Content-Type: application/json
{
  "ok": true,
  "affectedCount": 1
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/messages/:id/conversation/read" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/messages/{id}/forward
Auth required

Forward a message and optionally include attachments from the forwarded conversation slice

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{
  "recipients": [
    {
      "userId": "00000000-0000-4000-8000-000000000000",
      "type": "to"
    }
  ],
  "includeAttachments": true,
  "sendViaEmail": false
}

Responses

201Message forwarded
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
403Access denied
Content-Type: application/json
"string"
404Message not found
Content-Type: application/json
"string"
409Forward not allowed for message type
Content-Type: application/json
"string"
413Forward body exceeds maximum length
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/messages/:id/forward" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"recipients\": [
    {
      \"userId\": \"00000000-0000-4000-8000-000000000000\",
      \"type\": \"to\"
    }
  ],
  \"includeAttachments\": true,
  \"sendViaEmail\": false
}"
GET/messages/{id}/forward-preview
Auth required

Get forward preview for a message

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Forward preview generated
Content-Type: application/json
{
  "subject": "string",
  "body": "string"
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}
413Forward body exceeds maximum length
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/messages/:id/forward-preview" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/messages/{id}/read
Auth required

Mark message as read

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Message marked read
Content-Type: application/json
{
  "ok": true
}
403Access denied
Content-Type: application/json
{
  "error": "string"
}
404Message not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/messages/:id/read" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Feature Toggles

Showing 12 of 12 endpoints
GET/feature_toggles/check/boolean
Auth required

Check if feature is enabled

Checks if a feature toggle is enabled for the current context.

Parameters

NameInRequiredSchemaDescription
identifierqueryYesanyFeature toggle identifier

Responses

200Feature status
Content-Type: application/json
{
  "enabled": true,
  "source": "override",
  "toggleId": "string",
  "identifier": "string",
  "tenantId": "string"
}
400Bad Request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Tenant not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/check/boolean?identifier=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/check/json
Auth required

Get json config

Gets the json configuration for a feature toggle.

Parameters

NameInRequiredSchemaDescription
identifierqueryYesanyFeature toggle identifier

Responses

200Json config
Content-Type: application/json
{
  "valueType": "json",
  "source": "override",
  "toggleId": "string",
  "identifier": "string",
  "tenantId": "string"
}
400Bad Request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Tenant not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/check/json?identifier=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/check/number
Auth required

Get number config

Gets the number configuration for a feature toggle.

Parameters

NameInRequiredSchemaDescription
identifierqueryYesanyFeature toggle identifier

Responses

200Number config
Content-Type: application/json
{
  "valueType": "number",
  "value": 1,
  "source": "override",
  "toggleId": "string",
  "identifier": "string",
  "tenantId": "string"
}
400Bad Request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Tenant not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/check/number?identifier=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/check/string
Auth required

Get string config

Gets the string configuration for a feature toggle.

Parameters

NameInRequiredSchemaDescription
identifierqueryYesanyFeature toggle identifier

Responses

200String config
Content-Type: application/json
{
  "valueType": "string",
  "value": "string",
  "source": "override",
  "toggleId": "string",
  "identifier": "string",
  "tenantId": "string"
}
400Bad Request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Tenant not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/check/string?identifier=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/global
Auth required

List global feature toggles

Returns all global feature toggles with filtering and pagination. Requires superadmin role.

Parameters

NameInRequiredSchemaDescription
pagequeryNoanyPage number for pagination
pageSizequeryNoanyNumber of items per page (max 200)
searchqueryNoanyCase-insensitive search across identifier, name, description, and category
typequeryNoanyFilter by toggle type (boolean, string, number, json)
categoryqueryNoanyFilter by category (case-insensitive partial match)
namequeryNoanyFilter by name (case-insensitive partial match)
identifierqueryNoanyFilter by identifier (case-insensitive partial match)
sortFieldqueryNoanyField to sort by
sortDirqueryNoanySort direction (ascending or descending)

Responses

200Feature toggles collection
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "identifier": "string",
      "name": "string",
      "description": null,
      "category": null,
      "type": "boolean",
      "defaultValue": null,
      "createdAt": null,
      "updatedAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - superadmin role required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/global?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/feature_toggles/global
Auth required

Create global feature toggle

Creates a new global feature toggle. Requires superadmin role.

Request body (application/json)

{
  "identifier": "string",
  "name": "string",
  "description": null,
  "category": null,
  "type": "boolean",
  "defaultValue": null
}

Responses

201Feature toggle created
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - superadmin role required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/feature_toggles/global" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"identifier\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"category\": null,
  \"type\": \"boolean\",
  \"defaultValue\": null
}"
PUT/feature_toggles/global
Auth required

Update global feature toggle

Updates an existing global feature toggle. Requires superadmin role.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "description": null,
  "category": null,
  "defaultValue": null
}

Responses

200Feature toggle updated
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - superadmin role required
Content-Type: application/json
{
  "error": "string"
}
404Feature toggle not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/feature_toggles/global" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": null,
  \"category\": null,
  \"defaultValue\": null
}"
DELETE/feature_toggles/global
Auth required

Delete global feature toggle

Soft deletes a global feature toggle by ID. Requires superadmin role.

Parameters

NameInRequiredSchemaDescription
idqueryYesanyFeature toggle identifier

Responses

200Feature toggle deleted
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Invalid identifier
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden - superadmin role required
Content-Type: application/json
{
  "error": "string"
}
404Feature toggle not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/feature_toggles/global?id=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/global/{id}
Auth required

Fetch feature toggle by ID

Returns complete details of a feature toggle.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Feature toggle detail
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "identifier": "string",
  "name": "string",
  "description": null,
  "category": null,
  "type": "boolean",
  "defaultValue": null,
  "createdAt": null,
  "updatedAt": null
}
400Invalid identifier
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Feature toggle not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/global/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/global/{id}/override
Auth required

Fetch feature toggle override

Returns feature toggle override.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Feature toggle overrides
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "tenantName": "string",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "toggleType": "boolean",
  "updatedAt": null
}
400Invalid request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Feature toggle not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/global/:id/override" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/feature_toggles/overrides
Auth required

List overrides

Returns list of feature toggle overrides.

Parameters

NameInRequiredSchemaDescription
categoryqueryNoany—
namequeryNoany—
identifierqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200List of overrides
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "toggleId": "00000000-0000-4000-8000-000000000000",
      "tenantName": "string",
      "tenantId": "00000000-0000-4000-8000-000000000000",
      "identifier": "string",
      "name": "string",
      "category": "string",
      "isOverride": true
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1,
  "isSuperAdmin": true
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/feature_toggles/overrides?page=1&pageSize=25" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/feature_toggles/overrides
Auth required

Change override state

Enable, disable or inherit a feature toggle for a specific tenant.

Request body (application/json)

{
  "toggleId": "00000000-0000-4000-8000-000000000000",
  "isOverride": true
}

Responses

200Override updated
Content-Type: application/json
{
  "ok": true,
  "overrideToggleId": null
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Not found
Content-Type: application/json
{
  "error": "string"
}
500Internal server error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/feature_toggles/overrides" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"toggleId\": \"00000000-0000-4000-8000-000000000000\",
  \"isOverride\": true
}"

Currencies

Showing 14 of 14 endpoints
GET/currencies/currencies
Auth required

List currencies

Returns a paginated collection of currencies scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
idqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
isBasequeryNoany—
isActivequeryNoany—
codequeryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated currencies
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "code": "string",
      "name": "string",
      "symbol": null,
      "decimalPlaces": 1,
      "thousandsSeparator": null,
      "decimalSeparator": null,
      "isBase": true,
      "isActive": true,
      "createdAt": null,
      "updatedAt": null,
      "organizationId": "string",
      "tenantId": "string"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/currencies/currencies?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/currencies/currencies
Auth required

Create currency

Creates a new currency.

Request body (application/json)

{
  "organizationId": "string",
  "tenantId": "string",
  "code": "string",
  "name": "string",
  "symbol": null,
  "thousandsSeparator": null,
  "decimalSeparator": null
}

Responses

201Currency created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/currencies/currencies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"string\",
  \"tenantId\": \"string\",
  \"code\": \"string\",
  \"name\": \"string\",
  \"symbol\": null,
  \"thousandsSeparator\": null,
  \"decimalSeparator\": null
}"
PUT/currencies/currencies
Auth required

Update currency

Updates an existing currency by id.

Request body (application/json)

{
  "id": "string",
  "symbol": null,
  "thousandsSeparator": null,
  "decimalSeparator": null
}

Responses

200Currency updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/currencies/currencies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\",
  \"symbol\": null,
  \"thousandsSeparator\": null,
  \"decimalSeparator\": null
}"
DELETE/currencies/currencies
Auth required

Delete currency

Deletes a currency by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Currency deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/currencies/currencies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/currencies/currencies/options
Auth required

List currency options

Returns currencies formatted for select inputs.

Parameters

NameInRequiredSchemaDescription
qqueryNoany—
queryqueryNoany—
searchqueryNoany—
includeInactivequeryNoany—
limitqueryNoany—

Responses

200Option list
Content-Type: application/json
{
  "items": [
    {
      "value": "string",
      "label": "string"
    }
  ]
}
400Invalid query
Content-Type: application/json
{
  "items": []
}
401Unauthorized
Content-Type: application/json
{
  "items": []
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/currencies/currencies/options?limit=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/currencies/exchange-rates
Auth required

List exchangerates

Returns a paginated collection of exchangerates scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
idqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
fromCurrencyCodequeryNoany—
toCurrencyCodequeryNoany—
isActivequeryNoany—
sourcequeryNoany—
typequeryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated exchangerates
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "fromCurrencyCode": "string",
      "toCurrencyCode": "string",
      "rate": "string",
      "date": "string",
      "source": "string",
      "type": null,
      "isActive": true,
      "createdAt": null,
      "updatedAt": null,
      "organizationId": "00000000-0000-4000-8000-000000000000",
      "tenantId": "00000000-0000-4000-8000-000000000000"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/currencies/exchange-rates?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/currencies/exchange-rates
Auth required

Create exchangerate

Creates a new exchange rate.

Request body (application/json)

{
  "organizationId": "string",
  "tenantId": "string",
  "fromCurrencyCode": "string",
  "toCurrencyCode": "string",
  "rate": "string",
  "type": null
}

Responses

201ExchangeRate created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/currencies/exchange-rates" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"string\",
  \"tenantId\": \"string\",
  \"fromCurrencyCode\": \"string\",
  \"toCurrencyCode\": \"string\",
  \"rate\": \"string\",
  \"type\": null
}"
PUT/currencies/exchange-rates
Auth required

Update exchangerate

Updates an existing exchange rate by id.

Request body (application/json)

{
  "id": "string",
  "type": null
}

Responses

200ExchangeRate updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/currencies/exchange-rates" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\",
  \"type\": null
}"
DELETE/currencies/exchange-rates
Auth required

Delete exchangerate

Deletes an exchange rate by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200ExchangeRate deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/currencies/exchange-rates" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/currencies/fetch-configs
Auth required

List currency fetch configurations

Returns all currency fetch configurations scoped to the authenticated organization.

Responses

200A list of currency fetch configurations
Content-Type: application/json
{
  "configs": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "organizationId": "00000000-0000-4000-8000-000000000000",
      "tenantId": "00000000-0000-4000-8000-000000000000",
      "provider": "string",
      "isEnabled": true,
      "syncTime": null,
      "lastSyncAt": null,
      "lastSyncStatus": null,
      "lastSyncMessage": null,
      "lastSyncCount": null,
      "config": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/currencies/fetch-configs" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/currencies/fetch-configs
Auth required

Create currency fetch configuration

Creates a new currency fetch configuration.

Request body (application/json)

{
  "provider": "NBP",
  "isEnabled": false,
  "syncTime": null,
  "config": null
}

Responses

201Currency fetch configuration created successfully
Content-Type: application/json
{
  "config": {
    "id": "00000000-0000-4000-8000-000000000000",
    "organizationId": "00000000-0000-4000-8000-000000000000",
    "tenantId": "00000000-0000-4000-8000-000000000000",
    "provider": "string",
    "isEnabled": true,
    "syncTime": null,
    "lastSyncAt": null,
    "lastSyncStatus": null,
    "lastSyncMessage": null,
    "lastSyncCount": null,
    "config": null,
    "createdAt": "string",
    "updatedAt": "string"
  }
}
400Bad request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/currencies/fetch-configs" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"provider\": \"NBP\",
  \"isEnabled\": false,
  \"syncTime\": null,
  \"config\": null
}"
PUT/currencies/fetch-configs
Auth required

Update currency fetch configuration

Updates an existing currency fetch configuration by id.

Request body (application/json)

{
  "syncTime": null,
  "config": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Currency fetch configuration updated successfully
Content-Type: application/json
{
  "config": {
    "id": "00000000-0000-4000-8000-000000000000",
    "organizationId": "00000000-0000-4000-8000-000000000000",
    "tenantId": "00000000-0000-4000-8000-000000000000",
    "provider": "string",
    "isEnabled": true,
    "syncTime": null,
    "lastSyncAt": null,
    "lastSyncStatus": null,
    "lastSyncMessage": null,
    "lastSyncCount": null,
    "config": null,
    "createdAt": "string",
    "updatedAt": "string"
  }
}
400Bad request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/currencies/fetch-configs" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"syncTime\": null,
  \"config\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/currencies/fetch-configs
Auth required

Delete currency fetch configuration

Deletes a currency fetch configuration by id.

Parameters

NameInRequiredSchemaDescription
idqueryYesanyCurrency fetch configuration identifier to delete

Responses

200Currency fetch configuration deleted successfully
Content-Type: application/json
{
  "success": true
}
400Bad request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/currencies/fetch-configs?id=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/currencies/fetch-rates

Fetch currency rates

Fetches currency exchange rates from configured providers for a specific date.

Request body (application/json)

{}

Responses

200Currency rates fetched successfully
Content-Type: application/json
{
  "totalFetched": 1,
  "byProvider": {
    "key": {
      "count": 1
    }
  },
  "errors": [
    "string"
  ]
}
400Bad request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Internal server error
Content-Type: application/json
{
  "totalFetched": 1,
  "byProvider": {
    "key": {
      "count": 1
    }
  },
  "errors": [
    "string"
  ]
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/currencies/fetch-rates" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{}"

Progress

Showing 6 of 6 endpoints
GET/progress/active
Auth required

GET /progress/active

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/progress/active" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/progress/jobs
Auth required

List progressjobs

Returns a paginated collection of progressjobs scoped to the authenticated tenant.

Parameters

NameInRequiredSchemaDescription
statusqueryNoany—
jobTypequeryNoany—
parentJobIdqueryNoany—
includeCompletedqueryNoany—
completedSincequeryNoany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated progressjobs
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "jobType": "string",
      "name": "string",
      "description": null,
      "status": "string",
      "progressPercent": 1,
      "processedCount": 1,
      "totalCount": null,
      "etaSeconds": null,
      "cancellable": true,
      "startedAt": null,
      "finishedAt": null,
      "errorMessage": null,
      "createdAt": null,
      "tenantId": "00000000-0000-4000-8000-000000000000",
      "organizationId": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/progress/jobs?page=1&pageSize=20" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/progress/jobs
Auth required

Create progressjob

Creates a new progress job for tracking a long-running operation.

Request body (application/json)

{
  "jobType": "string",
  "name": "string",
  "cancellable": false
}

Responses

201ProgressJob created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/progress/jobs" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"jobType\": \"string\",
  \"name\": \"string\",
  \"cancellable\": false
}"
GET/progress/jobs/{id}
Auth required

GET /progress/jobs/{id}

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/progress/jobs/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/progress/jobs/{id}
Auth required

PUT /progress/jobs/{id}

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/progress/jobs/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/progress/jobs/{id}
Auth required

DELETE /progress/jobs/{id}

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

204Success

No response body.

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/progress/jobs/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Integrations

Showing 8 of 8 endpoints
GET/integrations
Auth required

List integrations

Returns a paginated collection of integrations.

Parameters

NameInRequiredSchemaDescription
qqueryNoany—
categoryqueryNoany—
bundleIdqueryNoany—
isEnabledqueryNoany—
healthStatusqueryNoany—
sortqueryNoany—
orderqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated integrations
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "title": "string",
      "description": null,
      "category": null,
      "tags": [
        "string"
      ],
      "hub": null,
      "providerKey": null,
      "bundleId": null,
      "author": null,
      "company": null,
      "version": null,
      "hasCredentials": true,
      "isEnabled": true,
      "apiVersion": null,
      "healthStatus": "healthy",
      "lastHealthCheckedAt": null,
      "lastHealthLatencyMs": null,
      "enabledAt": null,
      "analytics": {
        "lastActivityAt": null,
        "totalCount": 1,
        "errorCount": 1,
        "errorRate": 1,
        "dailyCounts": [
          1
        ]
      }
    }
  ],
  "total": 1,
  "totalPages": 1,
  "bundles": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "icon": null,
      "integrationCount": 1,
      "enabledCount": 1
    }
  ]
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/integrations?order=asc&page=1&pageSize=100" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/integrations/{id}
Auth required

Get integration detail

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/integrations/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/integrations/{id}/credentials
Auth required

Get or save integration credentials

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/integrations/:id/credentials" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/integrations/{id}/credentials
Auth required

Get or save integration credentials

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/integrations/:id/credentials" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/integrations/{id}/health
Auth required

Run health check for an integration

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/integrations/:id/health" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/integrations/{id}/state
Auth required

Update integration state

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/integrations/:id/state" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/integrations/{id}/version
Auth required

Change integration API version

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/integrations/:id/version" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/integrations/logs
Auth required

List integration logs

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/integrations/logs" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Communication Channels

Showing 1 of 1 endpoints
DELETE/communication_channels/channels/{id}
Auth required

DELETE /communication_channels/channels/{id}

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

204Success

No response body.

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/communication_channels/channels/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

AI Assistant

Showing 20 of 40 endpoints
GET/ai_assistant/ai/actions/{id}
Auth required

Fetch the current state of an AI pending action by id.

Returns the tenant-scoped {@link AiPendingAction} addressed by `:id`. Powers the chat UI reconnect/polling path: after a page reload or SSE reconnect the client carries the `pendingActionId` from an earlier `mutation-preview-card` UI part and calls this route to re-hydrate the card. Server-internal fields (`normalizedInput`, `createdByUserId`, `idempotencyKey`) are stripped by a whitelist serializer. Enforces tenant/org scoping via the repository.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Serialized pending action. Never includes normalizedInput, createdByUserId, or idempotencyKey.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"
404No pending action with the given id is accessible to the caller.
Content-Type: application/json
"string"
500Internal runtime failure.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/actions/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/ai_assistant/ai/actions/{id}/cancel
Auth required

Cancel an AI pending action without executing the wrapped tool.

Flips a pending AI action from `pending` to `cancelled` and emits the `ai.action.cancelled` event. The tool handler is never invoked. Idempotent: a second call on a row already in `cancelled` status returns 200 with the current row without re-emitting the event. Rows whose `expiresAt` is in the past are flipped to `expired` and returned as 409 `expired` so the client can surface the TTL loss instead of silently masking it as a cancellation.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Cancellation complete (or idempotent replay); body includes the serialized pending action with status `cancelled`.
Content-Type: application/json
"string"
400Invalid cancel request body (unknown field, reason exceeds 500 chars, wrong type).
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.view`.
Content-Type: application/json
"string"
404Pending action not found in the caller scope.
Content-Type: application/json
"string"
409Pending action is not in `pending` status (already confirmed/failed/executing) or has expired.
Content-Type: application/json
"string"
500Unexpected server failure during cancel.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/actions/:id/cancel" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/ai_assistant/ai/actions/{id}/confirm
Auth required

Confirm an AI pending action, re-running every server-side check before execution.

Re-verifies the full contract from spec §9.4 (status, expiry, agent registration, required features, mutation policy, tool whitelist, attachment tenant scope, record version, and schema drift), flips the pending-action state machine to `executing`, invokes the wrapped tool handler, and persists `executionResult`. Idempotent: a second call on a row already in `confirmed` state returns the prior result without re-executing the handler.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Confirmation complete; body includes the serialized pending action and the mutation result.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.view`, a required agent feature, tool whitelist, or accesses attachments outside their tenant.
Content-Type: application/json
"string"
404Pending action or agent not found in the caller scope.
Content-Type: application/json
"string"
409Pending action is not in `pending` status or has expired.
Content-Type: application/json
"string"
412Record version changed between propose and confirm, or the input schema no longer accepts the stored payload.
Content-Type: application/json
"string"
500Unexpected server failure during confirm.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/actions/:id/confirm" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/agents
Auth required

List registered AI agents, filtered by the caller's features.

Returns `{ agents: [...] }` — the subset of agents from `ai-agents.generated.ts` that the authenticated caller can invoke based on each agent's `requiredFeatures`. Mirrors the `meta.list_agents` tool handler so backoffice pages (e.g. the playground) can render an agent picker without going through the MCP tool transport.

Responses

200Accessible agent summaries.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
500Internal failure while loading the agent registry.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/agents/{agentId}/loop-override
Auth required

Read the current loop-policy override for this agent, if any.

Returns `{ agentId, override }` where `override` is the agent-scoped loop-policy row from `ai_agent_runtime_overrides` (or `null`). Requires `ai_assistant.view`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Loop override payload.
Content-Type: application/json
"string"
400Invalid agent id.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.view`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/loop-override" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/ai_assistant/ai/agents/{agentId}/loop-override
Auth required

Set (or replace) the tenant-scoped loop-policy override for this agent.

Body: loop columns. All fields are nullable/optional; `null` explicitly clears that axis. Validates `loopStopWhenJson` items and `loopActiveToolsJson` membership. Requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Request body (application/json)

{
  "loopDisabled": null,
  "loopMaxSteps": null,
  "loopMaxToolCalls": null,
  "loopMaxWallClockMs": null,
  "loopMaxTokens": null,
  "loopStopWhenJson": null,
  "loopActiveToolsJson": null
}

Responses

200Override persisted.
Content-Type: application/json
"string"
400Invalid agent id or validation error.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/loop-override" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"loopDisabled\": null,
  \"loopMaxSteps\": null,
  \"loopMaxToolCalls\": null,
  \"loopMaxWallClockMs\": null,
  \"loopMaxTokens\": null,
  \"loopStopWhenJson\": null,
  \"loopActiveToolsJson\": null
}"
DELETE/ai_assistant/ai/agents/{agentId}/loop-override
Auth required

Remove the loop-policy columns from the agent-scoped runtime override row.

Nulls out all seven loop columns on the agent-scoped `ai_agent_runtime_overrides` row. Idempotent — returns 200 even when no override exists. Requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Loop override cleared (or already absent).
Content-Type: application/json
"string"
400Invalid agent id.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/loop-override" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/agents/{agentId}/models
Auth required

Get the providers and curated models available for the chat-UI picker for this agent

Returns all configured providers with their curated model catalogs, filtered to providers that have an API key configured in the current environment. When the agent declares `allowRuntimeOverride: false`, the response reflects that constraint so the UI picker can hide itself. Includes the agent's resolved default provider/model so the picker can render a "(default)" badge next to the right entry. When a tenant-scoped lookup (the allowlist snapshot or the per-agent runtime override) cannot be loaded, the route still answers 200 with a partially resolved provider list and sets `degraded: true` plus a `degradedReason` code, so callers can tell a full entitlement list from a partial one. RBAC: requires the same features as the agent itself (typically `ai_assistant.view`).

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Providers and curated models available for the agent picker. Empty `providers` array when `allowRuntimeOverride` is false. `degraded` is `false` and `degradedReason` is `null` on a fully resolved response; `degraded: true` with `degradedReason: "tenant_allowlist_unavailable"` means a tenant-scoped lookup failed, so `providers` may be missing the tenant allowlist and/or the per-agent override narrowing — one code covers the whole tenant-scoped block because no client can act differently per source. Clients SHOULD render the list but MUST NOT treat it as the tenant's authoritative entitlement (for example, do not prune a stored model selection against it).
Content-Type: application/json
"string"
401Unauthenticated.
Content-Type: application/json
"string"
403Caller lacks the agent's required features.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/models" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/agents/{agentId}/mutation-policy
Auth required

Read the effective mutationPolicy for an agent — code-declared value plus any tenant override.

Returns `{ agentId, codeDeclared, override }` where `codeDeclared` is the agent's compiled-in `mutationPolicy` and `override` is the persisted tenant-scoped override (or `null`). Requires `ai_assistant.view`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Effective mutationPolicy payload.
Content-Type: application/json
"string"
400Invalid agent id.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.view`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/mutation-policy" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/ai_assistant/ai/agents/{agentId}/mutation-policy
Auth required

Set (or replace) the tenant-scoped mutationPolicy override for this agent.

Body: `{ mutationPolicy: "read-only" | "confirm-required" | "destructive-confirm-required", notes? }`. The override MUST NOT escalate beyond the agent's code-declared policy. Escalation attempts are rejected with 400 + `code: "escalation_not_allowed"`. Requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Request body (application/json)

{
  "mutationPolicy": "read-only"
}

Responses

200Override persisted.
Content-Type: application/json
"string"
400Invalid agent id, malformed body, or escalation attempt.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/mutation-policy" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"mutationPolicy\": \"read-only\"
}"
DELETE/ai_assistant/ai/agents/{agentId}/mutation-policy
Auth required

Remove the tenant-scoped mutationPolicy override for this agent.

Deletes the override row if it exists; subsequent calls fall back to the agent's code-declared policy. Idempotent — returns 200 even when no override exists. Requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Override cleared (or already absent).
Content-Type: application/json
"string"
400Invalid agent id.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/mutation-policy" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/agents/{agentId}/prompt-override

Read the latest prompt-section override for an agent plus recent version history.

Returns `{ agentId, override, versions }` where `override` is the latest persisted row (or `null`) and `versions` is the newest-first history capped at 10 rows. Tenant-scoped; requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Responses

200Latest override + recent version history.
Content-Type: application/json
"string"
400Invalid agent id.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/prompt-override" \
  -H "Accept: application/json"
POST/ai_assistant/ai/agents/{agentId}/prompt-override

Save a new prompt-section override version for the agent.

Persists an additive `{ sections: Record<sectionId, text>, notes? }` override, allocating the next monotonic version for `(tenant, org, agent)`. Reserved policy keys (`mutationPolicy`, `readOnly`, `allowedTools`, `acceptedMediaTypes`) are rejected with 400 / `reserved_key`. Requires `ai_assistant.settings.manage`.

Parameters

NameInRequiredSchemaDescription
agentIdpathYesany—

Request body (application/json)

{}

Responses

200Override persisted. Returns `{ ok: true, version, updatedAt }`.
Content-Type: application/json
"string"
400Invalid agent id, malformed body, or reserved policy key.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks `ai_assistant.settings.manage`.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/agents/:agentId/prompt-override" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{}"
POST/ai_assistant/ai/chat
Auth required

Stream a chat turn for a registered AI agent

Dispatches a chat turn to the focused AI agent identified by `?agent=<module>.<agent>`. Enforces agent-level `requiredFeatures`, tool whitelisting, read-only / mutationPolicy, execution-mode compatibility, and attachment media-type policy. The streaming response body uses an AI SDK-compatible `text/event-stream` transport. Optional `?provider=`, `?model=`, and `?baseUrl=` query params let callers override the resolved provider/model/base-URL for this turn (Phase 4a). Provider must be registered and configured; baseUrl must match `AI_RUNTIME_BASEURL_ALLOWLIST` when set. Both are suppressed when the agent declares `allowRuntimeOverride: false`.

Parameters

NameInRequiredSchemaDescription
agentqueryYesany—
providerqueryNoany—
modelqueryNoany—
baseUrlqueryNoany—
loopBudgetqueryNoany—

Request body (application/json)

{
  "messages": [
    {
      "role": "user",
      "content": "string"
    }
  ]
}

Responses

200Streaming text/event-stream response compatible with AI SDK chat transports.
Content-Type: text/event-stream
string
400Invalid query param, malformed payload, or message count above the cap. Typed codes: `runtime_override_disabled` (agent has allowRuntimeOverride:false), `provider_unknown` (provider id not registered), `provider_not_configured` (provider registered but no API key in env), `baseurl_not_allowlisted` (baseUrl not in AI_RUNTIME_BASEURL_ALLOWLIST).
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks agent-level or tool-level required features.
Content-Type: application/json
"string"
404Unknown agent id.
Content-Type: application/json
"string"
409Agent/tool/execution-mode policy violation.
Content-Type: application/json
"string"
500Internal runtime failure.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/chat?agent=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"messages\": [
    {
      \"role\": \"user\",
      \"content\": \"string\"
    }
  ]
}"
GET/ai_assistant/ai/conversations
Auth required

List AI chat conversations visible to the caller.

Returns `{ items, nextCursor }` for the authenticated caller, ordered by `lastMessageAt` descending. View-only callers receive only their own conversations. Callers with `ai_assistant.conversations.manage` may list conversations across users in the same tenant/organization. The `agent` and `status` filters are optional; `cursor` is the ISO timestamp returned by a previous response.

Responses

200Caller-owned conversation summaries.
Content-Type: application/json
"string"
400Invalid query parameters.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/ai_assistant/ai/conversations
Auth required

Idempotently create a new AI chat conversation.

If a non-deleted conversation already exists with the supplied `conversationId` for the authenticated caller in this tenant/org, returns the existing summary. Otherwise creates a fresh row and writes the owner-participant row in the same transaction.

Responses

200Existing conversation (idempotent path).
Content-Type: application/json
"string"
201Newly created conversation.
Content-Type: application/json
"string"
400Invalid request body.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/conversations/{conversationId}
Auth required

Fetch a conversation summary and recent transcript.

Returns `{ conversation, messages, nextCursor }` for the supplied `conversationId`. View-only callers can load only their own conversations. Callers with `ai_assistant.conversations.manage` can load conversations across users in the same tenant/organization. Messages are ordered ascending by `createdAt`. The `before` cursor returns the next older page when paging back through long transcripts.

Parameters

NameInRequiredSchemaDescription
conversationIdpathYesany—

Responses

200Conversation transcript page for the authenticated owner.
Content-Type: application/json
"string"
400Invalid path or query parameters.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"
404No conversation accessible to the caller.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations/:conversationId" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/ai_assistant/ai/conversations/{conversationId}
Auth required

Update an existing conversation.

Accepts a partial body containing any of `title`, `status`, `pageContext`. Setting `status` to `closed` archives the conversation while keeping its transcript intact. View-only callers can update only their own conversations; conversation managers can update conversations in the same tenant/organization.

Parameters

NameInRequiredSchemaDescription
conversationIdpathYesany—

Responses

200Updated conversation summary.
Content-Type: application/json
"string"
400Invalid request body.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"
404No conversation accessible to the caller.
Content-Type: application/json
"string"

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations/:conversationId" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/ai_assistant/ai/conversations/{conversationId}
Auth required

Soft-delete a conversation and its messages.

View-only callers can delete only their own conversations. Callers with `ai_assistant.conversations.manage` can delete conversations in the same tenant/organization. Marks the conversation row and every undeleted message row with a `deleted_at` timestamp in one transaction. The transcript remains in the database for audit/restore until a future retention worker hard-deletes it.

Parameters

NameInRequiredSchemaDescription
conversationIdpathYesany—

Responses

200Soft-delete acknowledgment.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks the `ai_assistant.view` feature.
Content-Type: application/json
"string"
404No conversation accessible to the caller.
Content-Type: application/json
"string"

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations/:conversationId" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/ai_assistant/ai/conversations/{conversationId}/participants
Auth required

List active participants of a conversation.

Returns the list of active (non-revoked) participants for the conversation. Only the conversation owner or a caller with `ai_assistant.conversations.manage` can call this endpoint.

Parameters

NameInRequiredSchemaDescription
conversationIdpathYesany—

Responses

200List of active participants.
Content-Type: application/json
"string"
401Unauthenticated caller.
Content-Type: application/json
"string"
403Caller lacks required features.
Content-Type: application/json
"string"
404Conversation not found or not accessible.
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/ai_assistant/ai/conversations/:conversationId/participants" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Product Catalog

Showing 3 of 3 endpoints
POST/catalog/bulk-delete
Auth required

Start bulk deleting catalog products

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/bulk-delete" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/categories/bulk-create
Auth required

Start bulk creating catalog categories

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/categories/bulk-create" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/products/bulk-create
Auth required

Start bulk creating catalog products

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/products/bulk-create" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Billing

Showing 20 of 56 endpoints
GET/billing/accounts
Auth required

List billingaccounts

Returns a paginated collection of billingaccounts scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idqueryNoany—
customerIdqueryNoany—
customerKindqueryNoany—
currencyCodequeryNoany—
billCyclequeryNoany—
billingModequeryNoany—
isActivequeryNoany—
searchqueryNoany—
hasOverduequeryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated billingaccounts
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "string",
      "customer_kind": "company",
      "name": "string",
      "currency_code": "string",
      "bill_cycle": "daily",
      "bill_cycle_interval": 1,
      "bill_cycle_day": null,
      "invoice_email": "string",
      "invoice_language": "string",
      "tax_id": null,
      "invoice_address": {},
      "next_bill_date": "string",
      "last_bill_date": null,
      "billing_mode": "string",
      "credit_limit": "string",
      "payment_terms_days": null,
      "auto_send_invoice": true,
      "balance_due": "string",
      "overdue_amount": "string",
      "is_active": true,
      "organization_id": "00000000-0000-4000-8000-000000000000",
      "tenant_id": "00000000-0000-4000-8000-000000000000",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/accounts?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/billing/accounts
Auth required

Create billingaccount

Creates a new billing account for a customer — a company or a person (`customerKind`, default `company`). `invoiceLanguage` must be a language supported by the invoice template (`en`, `es`, `de`, `pl`; default `en`). Bill cycle = every `billCycleInterval` (default 1) `billCycle` units (`daily` | `weekly` | `monthly` | `annually`, default `monthly`), pinned to `billCycleDay`: `1`–`31` for monthly / annually (a day past the end of a short month means its last day), `mon`–`sun` for weekly, omitted / null for daily. Omitted day → the day `nextBillDate` falls on, else `1` / `mon`. Omitted `nextBillDate` → the first bill cycle day on or after today (daily: today); an explicit date off the cycle day bills one short alignment period first.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "customerId": "string",
  "customerKind": "company",
  "name": "string",
  "currencyCode": "string",
  "billCycle": "monthly",
  "billCycleInterval": 1,
  "invoiceEmail": "user@example.com",
  "invoiceLanguage": "en",
  "taxId": null,
  "invoiceAddress": {
    "line1": "string",
    "city": "string",
    "postal_code": "string",
    "country": "string"
  },
  "lowBalanceThreshold": null,
  "paymentTermsDays": null
}

Responses

201BillingAccount created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/accounts" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"customerId\": \"string\",
  \"customerKind\": \"company\",
  \"name\": \"string\",
  \"currencyCode\": \"string\",
  \"billCycle\": \"monthly\",
  \"billCycleInterval\": 1,
  \"invoiceEmail\": \"user@example.com\",
  \"invoiceLanguage\": \"en\",
  \"taxId\": null,
  \"invoiceAddress\": {
    \"line1\": \"string\",
    \"city\": \"string\",
    \"postal_code\": \"string\",
    \"country\": \"string\"
  },
  \"lowBalanceThreshold\": null,
  \"paymentTermsDays\": null
}"
PUT/billing/accounts
Auth required

Update billingaccount

Updates a billing account. `currencyCode`, `customerId` and `customerKind` are immutable. Changing `billCycle`, `billCycleInterval` or `billCycleDay` without an explicit `nextBillDate` moves the next bill date to the next occurrence of the new bill cycle day; that Bill Run bills one short alignment period (in-advance charges prorated). An invalid cycle combination returns 400 `billing.account.invalid_bill_cycle`.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "id": "00000000-0000-4000-8000-000000000000",
  "taxId": null,
  "lastBillDate": null,
  "lowBalanceThreshold": null,
  "paymentTermsDays": null
}

Responses

200BillingAccount updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/billing/accounts" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"taxId\": null,
  \"lastBillDate\": null,
  \"lowBalanceThreshold\": null,
  \"paymentTermsDays\": null
}"
DELETE/billing/accounts
Auth required

Delete billingaccount

Soft-deletes a billing account (sets `deleted_at`).

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200BillingAccount deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/billing/accounts" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/billing/accounts/{id}/balance
Auth required

Get a prepaid account balance + status

Returns the current running balance, `balanceStatus` (ok/low/exhausted), the resolved low-balance threshold, the currency, and the last-movement timestamp for a prepaid account. 409 (`billing.account.not_prepaid`) for postpaid accounts.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/accounts/:id/balance" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/billing/accounts/{id}/credit-status
Auth required

Get an account credit status (both modes)

Returns `{ mode, creditLimit, creditUsed, availableCredit, creditStatus, currencyCode }`. Prepaid creditUsed = max(0,−balance); postpaid = Σ posted-unpaid invoice outstanding. Report-only — billing never blocks.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/accounts/:id/credit-status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/billing/accounts/{id}/summary
Auth required

Get a billing account receivables summary

Returns `{ bill_account_id, currency_code, open_amount, overdue_amount, overdue_count, credit_amount }` over posted / partially paid invoices and debit memos (test runs excluded). Overdue = past due date with outstanding > 0. `credit_amount` = unallocated payments + open credit memos. Spec F (account workspace) adds `billing_mode`, `bill_cycle`, `next_bill_date`, `last_invoice` (`{ id, number, issue_date, total_gross }` or null) and, for prepaid accounts, `prepaid { balance, balance_status, credit_limit, last_statement }` (null for postpaid).

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/accounts/:id/summary" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/billing/accounts/{id}/topups
Auth required

Initiate a prepaid top-up for an account

Registers a BillingTopup (pending) and opens a payment session. The path `id` is the prepaid account; the balance is credited on capture. Body: `{ amount, providerKey?, successUrl?, cancelUrl?, sourceRef? }`.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

201Success response
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/accounts/:id/topups" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/billing/export/account/{id}
Auth required

Export a billing account (GDPR portability)

Returns a JSON dump of a single Billing Account: the account itself, every Billing Item (no time cap — items often outlive a single export window), and the Usage records / BillRunOutcomes / emitted core/sales invoices / BillingDraftInvoiceEdit rows whose timestamps fall in the [since, until] window (defaults to the last 12 months). Each collection is independently capped by EXPORT_HARD_LIMIT = 50,000 rows. Lifetime dumps for outlier accounts need a follow-up chunked background-job approach — out of scope for this v1 endpoint.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/export/account/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/billing/invoices
Auth required

List billing documents

Paginated billing documents (invoices, credit / debit memos, top-up receipts) from `billing_invoices`. Filters: status, documentType, billRunId, billAccountId, testRun (`true`/`false`), id, number search, `overdue` (`true`/`false` — posted or partially paid, past due, outstanding > 0), `dueFrom` / `dueTo` (YYYY-MM-DD). Each row adds `days_overdue`. Fields use billing names: `number`, `document_type`, `total_gross`, `outstanding`, `bill_date`, `period_start/end`, `bill_account_name`, … (0.21.0 renamed them from the core-sales names — see MIGRATION.md).

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/invoices" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/billing/invoices/{id}
Auth required

Get a billing document (with lines)

Returns one billing document from `billing_invoices` (invoice, memo or receipt) with its lines, the frozen buyer / seller snapshots, `bill_account_name` and `allocations[]` (Spec C: payments / credit memos that settled it, with `source_label`) and `corrections[]` (Spec D memos). 404 outside the caller's organization.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Success response
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/invoices/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/billing/invoices/{id}/memos
Auth required

Create a credit or debit memo

Creates a draft memo for a posted / partially paid / paid invoice (a fully credited invoice accepts debit memos only). `reason` is required and printed. Credit memo without `lines` = full credit of every original line; lines with `correctsLineId` keep the original VAT rate; new lines default to the organization rate. Amounts are positive — the document type gives the sign.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{
  "type": "credit_memo",
  "reason": "string"
}

Responses

200`{ memoId, number, documentType, totalGross }`
Content-Type: application/json
"string"
400`billing.memo.invalid_line`
Content-Type: application/json
"string"
409`billing.memo.invalid_original` / `billing.memo.exceeds_invoice`
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/:id/memos" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"type\": \"credit_memo\",
  \"reason\": \"string\"
}"
GET/billing/invoices/{id}/pdf
Auth required

Download a billing document PDF

`application/pdf`. Posted documents return the PDF frozen at post (an attachment); drafts and test documents are rendered live with a DRAFT / TEST watermark and never stored. Labels follow the account invoice language (en / es / de / pl).

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200PDF document (`application/pdf`)
Content-Type: application/json
"string"
404Invoice not found in this organization
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/invoices/:id/pdf" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/billing/invoices/{id}/send
Auth required

Email a posted billing document

Sends the frozen PDF to the billing account invoice email through the platform email transport. Each attempt is appended to `metadata.deliveries` and emits `billing.invoice.sent` / `billing.invoice.send_failed`. Transport failures return 200 with `status: "failed"` and the error.

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Delivery attempted
Content-Type: application/json
{
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "to": "string",
  "status": "sent",
  "error": null
}
409`billing.invoice.not_posted` — drafts and test documents cannot be sent
Content-Type: application/json
"string"
422`billing.invoice.email_invalid` — placeholder or malformed invoice email
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/:id/send" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/billing/invoices/add-line
Auth required

Create billinginvoicelineadd

Appends a new line to a draft invoice (e.g. operator adds a one-off adjustment). Writes a `BillingDraftInvoiceEdit` audit row (action=`line_added`, `before_json=null`). Recomputes invoice totals. Refuses non-draft invoices.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "description": "string",
  "quantity": 1,
  "unitPriceNet": 1
}

Responses

201BillingInvoiceLineAdd created
Content-Type: application/json
{
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceLineId": "00000000-0000-4000-8000-000000000000",
  "auditId": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/add-line" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceId\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": \"string\",
  \"quantity\": 1,
  \"unitPriceNet\": 1
}"
POST/billing/invoices/delete-draft
Auth required

Delete a draft memo

Deletes a draft credit or debit memo with its lines. Posted documents are never deleted (no void).

Request body (application/json)

{
  "invoiceId": "00000000-0000-4000-8000-000000000000"
}

Responses

200`{ deleted: true }`
Content-Type: application/json
"string"
409`billing.memo.not_draft`
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/delete-draft" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"invoiceId\": \"00000000-0000-4000-8000-000000000000\"
}"
POST/billing/invoices/edit-line
Auth required

Create billinginvoicelineedit

Edits one line of a draft invoice (description, quantity, unit_price, or explicit `totalNetAmount` override). Writes a `BillingDraftInvoiceEdit` audit row with before+after snapshots and recomputes invoice totals. Refuses non-draft invoices with HTTP 409 + `billing.invoice.not_draft`.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceLineId": "00000000-0000-4000-8000-000000000000",
  "changes": {}
}

Responses

201BillingInvoiceLineEdit created
Content-Type: application/json
{
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceLineId": "00000000-0000-4000-8000-000000000000",
  "auditId": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/edit-line" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceLineId\": \"00000000-0000-4000-8000-000000000000\",
  \"changes\": {}
}"
POST/billing/invoices/post
Auth required

Create billinginvoicepost

Flips a billing-drafted `core/sales` invoice from `draft` to `posted`. Refuses non-draft invoices (409 / `billing.invoice.not_draft`) and test-mode invoices (409 / `billing.invoice.test_run`). Fires `billing.invoice.posted` + one `billing.invoice.line_posted` per line. The invoice number is NOT re-assigned (set at draft create — see Phase 2 deviation).

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "invoiceId": "00000000-0000-4000-8000-000000000000"
}

Responses

201BillingInvoicePost created
Content-Type: application/json
{
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceNumber": "string",
  "status": "posted",
  "lineCount": 1
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/post" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceId\": \"00000000-0000-4000-8000-000000000000\"
}"
POST/billing/invoices/remove-line
Auth required

Create billinginvoicelineremove

Removes one line from a draft invoice (hard delete — the line never existed as far as future readers are concerned). Writes a `BillingDraftInvoiceEdit` audit row (action=`line_removed`, `after_json=null`) carrying the before-snapshot for forensics. Recomputes invoice totals. Refuses non-draft invoices.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceLineId": "00000000-0000-4000-8000-000000000000"
}

Responses

201BillingInvoiceLineRemove created
Content-Type: application/json
{
  "invoiceId": "00000000-0000-4000-8000-000000000000",
  "invoiceLineId": "00000000-0000-4000-8000-000000000000",
  "auditId": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/billing/invoices/remove-line" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceId\": \"00000000-0000-4000-8000-000000000000\",
  \"invoiceLineId\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/billing/items
Auth required

List billingitems

Returns a paginated collection of billingitems scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idqueryNoany—
searchqueryNoany—
billAccountIdqueryNoany—
typequeryNoany—
subscriptionIdqueryNoany—
isActivequeryNoany—
activeAtqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated billingitems
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "bill_account_id": "00000000-0000-4000-8000-000000000000",
      "bill_account_name": null,
      "bill_account_currency": null,
      "bill_account_mode": null,
      "type": "string",
      "bill_start_date": "string",
      "bill_end_date": null,
      "description": "string",
      "rate_json": {},
      "uom_code": null,
      "subscription_id": null,
      "subscription_item_id": null,
      "source_ref": null,
      "currency_mismatch": true,
      "billed_to_date": null,
      "credit_reason": null,
      "charge_timing": "in_advance",
      "prorate": true,
      "tax_rate": "string",
      "price_basis": "net",
      "is_active": true,
      "organization_id": "00000000-0000-4000-8000-000000000000",
      "tenant_id": "00000000-0000-4000-8000-000000000000",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/billing/items?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Auth

Showing 1 of 1 endpoints
GET/auth/users/consents
Auth required

List user consents

Returns all consent records for a given user, with integrity verification status.

Parameters

NameInRequiredSchemaDescription
userIdqueryYesany—

Responses

200Consent list returned
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/auth/users/consents?userId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Catalog

Showing 20 of 37 endpoints
GET/catalog/categories
Auth required

List categories

Returns a paginated collection of categories scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
viewqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
statusqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated categories
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "slug": null,
      "description": null,
      "parentId": null,
      "parentName": null,
      "depth": 1,
      "treePath": "string",
      "pathLabel": "string",
      "childCount": 1,
      "descendantCount": 1,
      "isActive": true,
      "updatedAt": null,
      "organizationId": null,
      "tenantId": "00000000-0000-4000-8000-000000000000"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/categories?view=manage&page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/categories
Auth required

Create category

Creates a new product category.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "slug": null,
  "parentId": null
}

Responses

201Category created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/categories" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"name\": \"string\",
  \"slug\": null,
  \"parentId\": null
}"
PUT/catalog/categories
Auth required

Update category

Updates an existing category by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "slug": null,
  "parentId": null
}

Responses

200Category updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/catalog/categories" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"slug\": null,
  \"parentId\": null
}"
DELETE/catalog/categories
Auth required

Delete category

Deletes a category by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Category deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/catalog/categories" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/catalog/dictionaries/{key}
Auth required

Get dictionary entries by key

Returns dictionary entries for a specific key (e.g., currency, unit).

Parameters

NameInRequiredSchemaDescription
keypathYesany—

Responses

200Dictionary entries
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "entries": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "value": "string",
      "label": "string",
      "color": null,
      "icon": null
    }
  ]
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/dictionaries/:key" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/catalog/offers
Auth required

List offers

Returns a paginated collection of offers scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
productIdqueryNoany—
channelIdqueryNoany—
channelIdsqueryNoany—
idqueryNoany—
searchqueryNoany—
isActivequeryNoany—
withDeletedqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated offers
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "productId": null,
      "organizationId": null,
      "tenantId": null,
      "channelId": null,
      "title": "string",
      "description": null,
      "defaultMediaId": null,
      "defaultMediaUrl": null,
      "metadata": null,
      "isActive": null,
      "createdAt": null,
      "updatedAt": null,
      "product": null,
      "productChannelPrice": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/offers?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/offers
Auth required

Create offer

Creates a new offer linking a product to a sales channel.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "channelId": "00000000-0000-4000-8000-000000000000",
  "title": "string",
  "defaultMediaId": null,
  "defaultMediaUrl": null,
  "productId": "00000000-0000-4000-8000-000000000000"
}

Responses

201Offer created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/offers" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"channelId\": \"00000000-0000-4000-8000-000000000000\",
  \"title\": \"string\",
  \"defaultMediaId\": null,
  \"defaultMediaUrl\": null,
  \"productId\": \"00000000-0000-4000-8000-000000000000\"
}"
PUT/catalog/offers
Auth required

Update offer

Updates an existing offer by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "defaultMediaId": null,
  "defaultMediaUrl": null
}

Responses

200Offer updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/catalog/offers" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"defaultMediaId\": null,
  \"defaultMediaUrl\": null
}"
DELETE/catalog/offers
Auth required

Delete offer

Deletes an offer by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Offer deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/catalog/offers" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/catalog/option-schemas
Auth required

List option schemas

Returns a paginated collection of option schemas scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
searchqueryNoany—
isActivequeryNoany—
withDeletedqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated option schemas
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "code": null,
      "description": null,
      "schema": null,
      "metadata": null,
      "is_active": null,
      "created_at": null,
      "updated_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/option-schemas?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/option-schemas
Auth required

Create option schema

Creates a new option schema template for product configurations.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "schema": {
    "options": [
      {
        "code": "string",
        "label": "string",
        "inputType": "select"
      }
    ]
  }
}

Responses

201Option Schema created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/option-schemas" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"name\": \"string\",
  \"schema\": {
    \"options\": [
      {
        \"code\": \"string\",
        \"label\": \"string\",
        \"inputType\": \"select\"
      }
    ]
  }
}"
PUT/catalog/option-schemas
Auth required

Update option schema

Updates an existing option schema by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Option Schema updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/catalog/option-schemas" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/catalog/option-schemas
Auth required

Delete option schema

Deletes an option schema by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Option Schema deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/catalog/option-schemas" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/catalog/price-kinds
Auth required

List price kinds

Returns a paginated collection of price kinds scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
isPromotionqueryNoany—
isActivequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated price kinds
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "organization_id": null,
      "tenant_id": null,
      "code": "string",
      "title": "string",
      "display_mode": null,
      "currency_code": null,
      "is_promotion": null,
      "is_active": null,
      "created_at": null,
      "updated_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/price-kinds?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/price-kinds
Auth required

Create price kind

Creates a new price kind for categorizing product prices.

Request body (application/json)

{
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "code": "string",
  "title": "string",
  "displayMode": "excluding-tax"
}

Responses

201Price Kind created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/price-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"code\": \"string\",
  \"title\": \"string\",
  \"displayMode\": \"excluding-tax\"
}"
PUT/catalog/price-kinds
Auth required

Update price kind

Updates an existing price kind by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "displayMode": "excluding-tax"
}

Responses

200Price Kind updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/catalog/price-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"displayMode\": \"excluding-tax\"
}"
DELETE/catalog/price-kinds
Auth required

Delete price kind

Deletes a price kind by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Price Kind deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/catalog/price-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/catalog/prices
Auth required

List prices

Returns a paginated collection of prices scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
productIdqueryNoany—
variantIdqueryNoany—
offerIdqueryNoany—
channelIdqueryNoany—
currencyCodequeryNoany—
priceKindIdqueryNoany—
kindqueryNoany—
userIdqueryNoany—
userGroupIdqueryNoany—
customerIdqueryNoany—
customerGroupIdqueryNoany—
quantityqueryNoany—
quantityUnitqueryNoany—
withDeletedqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated prices
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "product_id": null,
      "variant_id": null,
      "offer_id": null,
      "currency_code": null,
      "price_kind_id": null,
      "kind": null,
      "min_quantity": null,
      "max_quantity": null,
      "unit_price_net": null,
      "unit_price_gross": null,
      "tax_rate": null,
      "tax_amount": null,
      "channel_id": null,
      "user_id": null,
      "user_group_id": null,
      "customer_id": null,
      "customer_group_id": null,
      "metadata": null,
      "starts_at": null,
      "ends_at": null,
      "created_at": null,
      "updated_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/catalog/prices?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/catalog/prices
Auth required

Create price

Creates a new price entry for a product or variant.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "currencyCode": "string",
  "priceKindId": "00000000-0000-4000-8000-000000000000",
  "taxRateId": null
}

Responses

201Price created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/catalog/prices" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"currencyCode\": \"string\",
  \"priceKindId\": \"00000000-0000-4000-8000-000000000000\",
  \"taxRateId\": null
}"
PUT/catalog/prices
Auth required

Update price

Updates an existing price by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "taxRateId": null
}

Responses

200Price updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/catalog/prices" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"taxRateId\": null
}"

CommunicationChannels

Showing 20 of 22 endpoints
DELETE/communication_channels/admin/channels/{id}
Auth required

Admin delete (soft-delete) a tenant-wide communication channel

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

204Channel deleted

No response body.

400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found or not a tenant-wide channel
Content-Type: application/json
"string"

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/communication_channels/admin/channels/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/communication_channels/channels
Auth required

List communication channels for the current tenant

Responses

200Channel list (paginated)
Content-Type: application/json
"string"
400Invalid query parameters
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/communication_channels/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/communication_channels/channels/{id}
Auth required

Get a single communication channel by id

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Channel detail
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/communication_channels/channels/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/communication_channels/channels/{id}/health
Auth required

Snapshot of channel delivery health (last 24h)

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Health snapshot
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/health" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/{id}/import-history
Auth required

Queue a backlog import for a channel (Spec B § Phase B6)

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Request body (application/json)

{
  "sinceDays": 30,
  "maxMessages": 1000
}

Responses

202Import job queued; returns { progressJobId }
Content-Type: application/json
"string"
400Invalid channel id or unsupported provider
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found / not accessible
Content-Type: application/json
"string"
409Channel is not connected (requires reauth / error)
Content-Type: application/json
"string"
429Another import is already running for this channel
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/import-history" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"sinceDays\": 30,
  \"maxMessages\": 1000
}"
POST/communication_channels/channels/{id}/poll-now
Auth required

Manually trigger a poll cycle for a channel (demo / operator override)

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

202Poll job enqueued
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found
Content-Type: application/json
"string"
409Channel disabled, not connected, or push-driven (never polled)
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/poll-now" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/{id}/push/register
Auth required

Force-register push delivery for a channel (Spec C § Phase C5)

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

202Push registration attempted; check result.pushStatus
Content-Type: application/json
"string"
400Invalid id or unsupported provider
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Missing push.manage feature
Content-Type: application/json
"string"
404Channel not found
Content-Type: application/json
"string"
409Provider does not support push (IMAP)
Content-Type: application/json
"string"
502Provider returned an error during registration
Content-Type: application/json
"string"
503Webhook base URL or Pub/Sub topic not configured
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/push/register" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/{id}/set-primary
Auth required

Mark a per-user channel as primary

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Channel set as primary (or already primary)
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found or not owned by current user
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/set-primary" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/{id}/test-send
Auth required

Diagnostic — send a test message through the channel without persisting

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Test send result
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Not allowed to manage this channel
Content-Type: application/json
"string"
404Channel or adapter not found
Content-Type: application/json
"string"
409Channel not connected
Content-Type: application/json
"string"
422Invalid request body
Content-Type: application/json
"string"
502Provider error
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/test-send" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/communication_channels/channels/{id}/visibility
Auth required

Mark your own personal channel as a shared team mailbox (or private again)

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Visibility updated (or already at that value)
Content-Type: application/json
"string"
400Invalid channel id
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Channel not found or not owned by current user
Content-Type: application/json
"string"
409Optimistic lock conflict
Content-Type: application/json
"string"
422Invalid body
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/communication_channels/channels/:id/visibility" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/connect/credentials
Auth required

Connect a credential-based per-user channel (IMAP/SMTP)

Responses

201Channel connected
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Provider is tenant-scoped — use the tenant connect route
Content-Type: application/json
"string"
404Unknown provider
Content-Type: application/json
"string"
409Mailbox already connected via another provider
Content-Type: application/json
"string"
422Invalid body or credential validation failed
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/connect/credentials" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/channels/connect/tenant-credentials
Auth required

Connect a tenant-wide credential-based channel (push: FCM/APNs/Expo)

Responses

201Channel connected
Content-Type: application/json
"string"
400Provider is not tenant-scoped
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Unknown provider
Content-Type: application/json
"string"
422Invalid body or credential validation failed
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/channels/connect/tenant-credentials" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/communication_channels/me/channels
Auth required

List the current user's connected channels

Responses

200List of user-owned channels
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/communication_channels/me/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/messages/{messageId}/reactions
Auth required

Add a reaction to a channel-linked message

Parameters

NameInRequiredSchemaDescription
messageIdpathYesany—

Responses

201Reaction added
Content-Type: application/json
"string"
400Invalid messageId
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Channel is owned by another user
Content-Type: application/json
"string"
409Message not channel-linked or duplicate reaction
Content-Type: application/json
"string"
422Invalid request body
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/messages/:messageId/reactions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/communication_channels/messages/{messageId}/reactions/{reactionId}
Auth required

Remove a reaction from a channel-linked message

Parameters

NameInRequiredSchemaDescription
messageIdpathYesany—
reactionIdpathYesany—

Responses

204Reaction removed

No response body.

400Invalid params
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Channel is owned by another user
Content-Type: application/json
"string"
404Reaction not found or not owned by current user
Content-Type: application/json
"string"
409Message not channel-linked
Content-Type: application/json
"string"

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/communication_channels/messages/:messageId/reactions/:reactionId" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/communication_channels/oauth/{provider}/callback
Auth required

OAuth callback — exchange code, persist credentials, create per-user channel

Parameters

NameInRequiredSchemaDescription
providerpathYesany—

Responses

200Success response
Content-Type: application/json
"string"
302Redirect back to returnUrl with flash query params
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/communication_channels/oauth/:provider/callback" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/oauth/{provider}/initiate
Auth required

Start a per-user channel OAuth flow

Parameters

NameInRequiredSchemaDescription
providerpathYesany—

Responses

200Authorize URL + state cookie set
Content-Type: application/json
"string"
400Invalid provider or unsupported (no OAuth)
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
422Invalid request body
Content-Type: application/json
"string"
502Adapter failed to build authorize URL
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/oauth/:provider/initiate" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/send-as-user
Auth required

Send a message through the current user's own channel

Responses

202Message persisted; outbound delivery enqueued
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
403Cannot send through a channel you don't own
Content-Type: application/json
"string"
404Channel not found
Content-Type: application/json
"string"
409Channel in a non-deliverable transitional status
Content-Type: application/json
"string"
422Invalid body, or channel requires_reauth / disconnected
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/send-as-user" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/communication_channels/test-seed
Auth required

Test-only: seed a connected channel, ingest a real inbound message, or emit a seeded inbound link (env-gated)

Responses

201Channel seeded / inbound message emitted
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Test channel seeding disabled (production default), or the requested channel does not belong to the caller
Content-Type: application/json
"string"
422Invalid request body
Content-Type: application/json
"string"
500Seed failed
Content-Type: application/json
"string"

Example

curl -X POST "https://walix-demo.dainamite.com/api/communication_channels/test-seed" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/communication_channels/threads/{threadId}/assign
Auth required

Reassign a channel-linked conversation to a different owner

Parameters

NameInRequiredSchemaDescription
threadIdpathYesany—

Responses

200Conversation reassigned (or unchanged)
Content-Type: application/json
"string"
400Invalid threadId
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
"string"
404Conversation not channel-linked
Content-Type: application/json
"string"
422Invalid request body
Content-Type: application/json
"string"

Example

curl -X PUT "https://walix-demo.dainamite.com/api/communication_channels/threads/:threadId/assign" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Configs

Showing 8 of 8 endpoints
GET/configs/cache
Auth required

Get cache statistics

Returns detailed cache statistics including total entries and breakdown by cache segments. Requires cache service to be available.

Responses

200Cache statistics
Content-Type: application/json
{
  "generatedAt": "string",
  "totalKeys": 1,
  "segments": [
    {
      "segment": "string",
      "resource": null,
      "method": null,
      "path": null,
      "keyCount": 1,
      "keys": [
        "string"
      ]
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to resolve cache stats
Content-Type: application/json
{
  "error": "string"
}
503Cache service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/configs/cache" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/configs/cache
Auth required

Purge cache

Purges cache entries. Supports two actions: purgeAll (clears entire cache) or purgeSegment (clears specific segment). Returns updated cache statistics after purge.

Request body (application/json)

{
  "action": "purgeAll"
}

Responses

200Cache segment cleared successfully
Content-Type: application/json
{
  "action": "purgeSegment",
  "segment": "string",
  "deleted": 1,
  "stats": {
    "generatedAt": "string",
    "totalKeys": 1,
    "segments": [
      {
        "segment": "string",
        "resource": null,
        "method": null,
        "path": null,
        "keyCount": 1,
        "keys": [
          "string"
        ]
      }
    ]
  }
}
400Invalid request - missing segment identifier for purgeSegment action
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to purge cache
Content-Type: application/json
{
  "error": "string"
}
503Cache service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/configs/cache" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"action\": \"purgeAll\"
}"
GET/configs/module-telemetry
Auth required

Get module resource usage telemetry

Returns in-process module resource attribution for API routes, event subscribers, and queue workers.

Responses

200Module resource usage report
Content-Type: application/json
{
  "generatedAt": "string",
  "startedAt": "string",
  "enabled": true,
  "bucketIntervalMs": 1,
  "totals": {
    "modules": 1,
    "operations": 1,
    "calls": 1,
    "errors": 1,
    "totalDurationMs": 1,
    "totalCpuMs": 1,
    "positiveHeapDeltaBytes": 1,
    "positiveRssDeltaBytes": 1
  },
  "thresholds": {
    "p95DurationMs": 1,
    "cpuMs": 1,
    "positiveHeapDeltaBytes": 1,
    "positiveRssDeltaBytes": 1,
    "errors": 1
  },
  "modules": [
    {
      "moduleId": "string",
      "calls": 1,
      "errors": 1,
      "totalDurationMs": 1,
      "p95DurationMs": 1,
      "totalCpuMs": 1,
      "positiveHeapDeltaBytes": 1,
      "positiveRssDeltaBytes": 1,
      "surfaces": [
        {
          "surface": "api",
          "calls": 1,
          "errors": 1,
          "totalDurationMs": 1,
          "p95DurationMs": 1,
          "totalCpuMs": 1,
          "positiveHeapDeltaBytes": 1,
          "positiveRssDeltaBytes": 1
        }
      ],
      "topOperations": [
        {
          "moduleId": "string",
          "surface": "api",
          "operation": "string",
          "resourceId": null,
          "calls": 1,
          "errors": 1,
          "totalDurationMs": 1,
          "maxDurationMs": 1,
          "p95DurationMs": 1,
          "totalCpuUserMs": 1,
          "totalCpuSystemMs": 1,
          "maxCpuMs": 1,
          "totalHeapDeltaBytes": 1,
          "positiveHeapDeltaBytes": 1,
          "maxHeapDeltaBytes": 1,
          "totalRssDeltaBytes": 1,
          "positiveRssDeltaBytes": 1,
          "maxRssDeltaBytes": 1,
          "firstSeenAt": "string",
          "lastSeenAt": "string"
        }
      ],
      "candidateReasons": [
        "string"
      ]
    }
  ],
  "candidates": [
    {
      "moduleId": "string",
      "calls": 1,
      "errors": 1,
      "totalDurationMs": 1,
      "p95DurationMs": 1,
      "totalCpuMs": 1,
      "positiveHeapDeltaBytes": 1,
      "positiveRssDeltaBytes": 1,
      "surfaces": [
        {
          "surface": "api",
          "calls": 1,
          "errors": 1,
          "totalDurationMs": 1,
          "p95DurationMs": 1,
          "totalCpuMs": 1,
          "positiveHeapDeltaBytes": 1,
          "positiveRssDeltaBytes": 1
        }
      ],
      "topOperations": [
        {
          "moduleId": "string",
          "surface": "api",
          "operation": "string",
          "resourceId": null,
          "calls": 1,
          "errors": 1,
          "totalDurationMs": 1,
          "maxDurationMs": 1,
          "p95DurationMs": 1,
          "totalCpuUserMs": 1,
          "totalCpuSystemMs": 1,
          "maxCpuMs": 1,
          "totalHeapDeltaBytes": 1,
          "positiveHeapDeltaBytes": 1,
          "maxHeapDeltaBytes": 1,
          "totalRssDeltaBytes": 1,
          "positiveRssDeltaBytes": 1,
          "maxRssDeltaBytes": 1,
          "firstSeenAt": "string",
          "lastSeenAt": "string"
        }
      ],
      "candidateReasons": [
        "string"
      ]
    }
  ],
  "buckets": [
    {
      "bucketStart": "string",
      "bucketEnd": "string",
      "bucketIntervalMs": 1,
      "stage": "startup",
      "partial": true,
      "totals": {
        "modules": 1,
        "calls": 1,
        "errors": 1,
        "totalDurationMs": 1,
        "totalCpuMs": 1,
        "positiveHeapDeltaBytes": 1,
        "positiveRssDeltaBytes": 1
      },
      "modules": [
        {
          "moduleId": "string",
          "calls": 1,
          "errors": 1,
          "totalDurationMs": 1,
          "p95DurationMs": 1,
          "totalCpuMs": 1,
          "positiveHeapDeltaBytes": 1,
          "positiveRssDeltaBytes": 1,
          "surfaces": [
            {
              "surface": "api",
              "calls": 1,
              "errors": 1,
              "totalDurationMs": 1,
              "p95DurationMs": 1,
              "totalCpuMs": 1,
              "positiveHeapDeltaBytes": 1,
              "positiveRssDeltaBytes": 1
            }
          ],
          "topOperations": [
            {
              "moduleId": "string",
              "surface": "api",
              "operation": "string",
              "resourceId": null,
              "calls": 1,
              "errors": 1,
              "totalDurationMs": 1,
              "maxDurationMs": 1,
              "p95DurationMs": 1,
              "totalCpuUserMs": 1,
              "totalCpuSystemMs": 1,
              "maxCpuMs": 1,
              "totalHeapDeltaBytes": 1,
              "positiveHeapDeltaBytes": 1,
              "maxHeapDeltaBytes": 1,
              "totalRssDeltaBytes": 1,
              "positiveRssDeltaBytes": 1,
              "maxRssDeltaBytes": 1,
              "firstSeenAt": "string",
              "lastSeenAt": "string"
            }
          ],
          "candidateReasons": [
            "string"
          ]
        }
      ]
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/configs/module-telemetry" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
DELETE/configs/module-telemetry
Auth required

Clear module telemetry data

Development-only endpoint that clears in-memory module telemetry and local process telemetry files.

Responses

200Module telemetry cleared
Content-Type: application/json
{
  "cleared": true
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden outside development mode
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/configs/module-telemetry" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/configs/system-status
Auth required

Get system health status

Returns comprehensive system health information including environment details, version, resource usage, and service connectivity status.

Responses

200System status snapshot
Content-Type: application/json
{
  "generatedAt": "string",
  "runtimeMode": "development",
  "categories": [
    {
      "key": "profiling",
      "labelKey": "string",
      "descriptionKey": null,
      "items": [
        {
          "key": "string",
          "category": "profiling",
          "kind": "boolean",
          "labelKey": "string",
          "descriptionKey": "string",
          "docUrl": null,
          "defaultValue": null,
          "state": "enabled",
          "value": null,
          "normalizedValue": null
        }
      ]
    }
  ]
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to load system status
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/configs/system-status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/configs/system-status
Auth required

Clear system cache

Purges the entire cache for the current tenant. Useful for troubleshooting or forcing fresh data loading.

Responses

200Cache cleared successfully
Content-Type: application/json
{
  "cleared": true
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to purge cache
Content-Type: application/json
{
  "error": "string"
}
503Cache service unavailable
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/configs/system-status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/configs/upgrade-actions
Auth required

List pending upgrade actions

Returns a list of pending upgrade actions for the current version. These are one-time setup tasks that need to be executed after upgrading to a new version. Requires organization and tenant context.

Responses

200List of pending upgrade actions
Content-Type: application/json
{
  "version": "string",
  "actions": [
    {
      "id": "string",
      "version": "string",
      "message": "string",
      "ctaLabel": "string",
      "successMessage": "string",
      "loadingLabel": "string"
    }
  ]
}
400Missing organization or tenant context
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
500Failed to load upgrade actions
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/configs/upgrade-actions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/configs/upgrade-actions
Auth required

Execute upgrade action

Executes a specific upgrade action by ID. Typically used for one-time setup tasks like seeding example data after version upgrade. Returns execution status and localized success message.

Request body (application/json)

{
  "actionId": "string"
}

Responses

200Upgrade action executed successfully
Content-Type: application/json
{
  "status": "string",
  "message": "string",
  "version": "string"
}
400Invalid request body or missing context
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Upgrade actions are disabled
Content-Type: application/json
{
  "error": "string"
}
500Failed to execute upgrade action
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/configs/upgrade-actions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"actionId\": \"string\"
}"

CPQ Billing Connector

Showing 2 of 2 endpoints
GET/cpq_billing_connector/order-setups/{orderId}
Auth required

Get the billing setup of a CPQ order

Returns `setup` (null until saved), `editable` (order is `draft` / `pending_activation`, a new-sale order, and the setup is not yet applied), `defaults.account` (new-account values from the sales order customer snapshot; absent fields fall back to placeholders at activation) and `defaults.lines` (billable lines with their CPQ service start). Account candidates come from `GET /api/billing/accounts?customerId&currencyCode&isActive=true`. For ARC amend / cancel orders, `earliestActivationDate` (YYYY-MM-DD) is the first day the order may be activated — the day billing of every target subscription has begun (per subscription its earliest active item's bill start) — with `earliestActivationReason { subscriptionId, itemDescription }`; both are null for other orders. Activating earlier is rejected by the connector guard (422 `cpq_billing_connector.activation_before_billing_start`).

Parameters

NameInRequiredSchemaDescription
orderIdpathYesany—

Responses

200The order billing setup view
Content-Type: application/json
"string"
400Invalid order id
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404CPQ order not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq_billing_connector/order-setups/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/cpq_billing_connector/order-setups/{orderId}
Auth required

Save the billing setup of a CPQ order

Full replacement. `accountMode: "existing"` needs `billingAccountId` (active, same customer, same currency); `accountMode: "new"` takes optional `accountOverrides` (only the fields that differ from the customer). `defaultBillStartDate` null = activation date. `lineBillStarts` maps a line id (the `lineId` of `GET /api/cpq/orders/:orderId`) to a `YYYY-MM-DD` bill start. Effective bill start per line: line override → CPQ service start → `defaultBillStartDate` → activation date. Undoable.

Parameters

NameInRequiredSchemaDescription
orderIdpathYesany—

Request body (application/json)

{
  "billingAccountId": null,
  "defaultBillStartDate": null
}

Responses

200The saved order billing setup view
Content-Type: application/json
"string"
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404CPQ order not found
Content-Type: application/json
{
  "error": "string"
}
409Order is not editable (status, quote type, or setup already applied)
Content-Type: application/json
{
  "error": "string"
}
422Billing account not usable for this order, or a line is not on this order
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq_billing_connector/order-setups/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"billingAccountId\": null,
  \"defaultBillStartDate\": null
}"

CPQ Quotes

Showing 20 of 20 endpoints
GET/cpq/attribute-options
Auth required

Resolve picklist options for a product attribute

Used by the quoting wizard. Returns the options of one attribute, including dynamic options sourced from pricing tables and options narrowed by `dependsOn` constraints against the current configuration.

Parameters

NameInRequiredSchemaDescription
productIdqueryYesany—
attributeCodequeryYesany—
configurationqueryNoanyJSON-encoded object of the attribute values selected so far

Responses

200`{ items }` resolved options
Content-Type: application/json
"string"
400productId and attributeCode are required, or configuration is not valid JSON
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/attribute-options?productId=string&attributeCode=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/quotes
Auth required

List CPQ quotes

Paged list of CPQ quote configurations, each enriched with the sales `quoteNumber`. `search` matches quoteId or customerId.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
cpqStatusqueryNoany—
currencyCodequeryNoany—
customerIdqueryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200`{ items, total, page, pageSize, totalPages }`
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/quotes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes
Auth required

Create a CPQ quote for a customer

Creates the CPQ quote configuration and its sales quote header (or links an existing sales quote via `quoteId`). Lines are added afterwards via `POST /api/cpq/quotes/{quoteId}/items`.

Request body (application/json)

{
  "customerId": "00000000-0000-4000-8000-000000000000",
  "quoteType": "new"
}

Responses

201Created quote
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Customer or sales quote not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"customerId\": \"00000000-0000-4000-8000-000000000000\",
  \"quoteType\": \"new\"
}"
GET/cpq/quotes/{quoteId}
Auth required

Get a CPQ quote with its lines and totals

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Responses

200Quote with lines, charges and totals
Content-Type: application/json
"string"
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/cpq/quotes/{quoteId}
Auth required

Change the quote type of a CPQ quote (ARC)

Only `quoteType` is updatable. The transition is one-way: `new` to `amend`, `renew` or `cancel`; any later change returns 409.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{}

Responses

200Quote with its new type
Content-Type: application/json
"string"
400Validation error, nothing to update, or transition back to `new`
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Quote type is immutable
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
DELETE/cpq/quotes/{quoteId}
Auth required

Soft-delete a CPQ quote

Soft-deletes the CPQ quote and its line configurations, and deletes the underlying sales quote and its lines through the sales module command `sales.quotes.delete` (sales events, audit log and undo apply). `quoteId` may be the CPQ configuration id or the sales quote id. Quotes in a terminal status (accepted, rejected, cancelled) cannot be deleted.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Responses

200`{ ok: true }`
Content-Type: application/json
{
  "ok": true
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is in a terminal status
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/clone
Auth required

Clone a CPQ quote with its lines

Creates a new quote (sales quote header plus CPQ configuration) copied from the source quote, then reprices it.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Responses

201The newly created quote
Content-Type: application/json
"string"
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/clone" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/items
Auth required

Add a configured line to a CPQ quote

Prices the line and recalculates the quote. Mutation guards run first (resource kind `cpq.quote_line`, create). `_arc*` configuration keys are server-owned and ignored.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "configuration": {},
  "quantity": 1,
  "action": "add",
  "targetSubscriptionId": null,
  "sourceSubscriptionItemId": null
}

Responses

201Quote after the line was added
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote or line not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is in a terminal status
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"configuration\": {},
  \"quantity\": 1,
  \"action\": \"add\",
  \"targetSubscriptionId\": null,
  \"sourceSubscriptionItemId\": null
}"
PUT/cpq/quotes/{quoteId}/items/{lineId}
Auth required

Update a quote line (configuration, quantity, term)

Re-prices the line unless it is a frozen Amend mirror line whose pricing inputs are unchanged. Mutation guards run first (resource kind `cpq.quote_line`, update). `_arc*` configuration keys are server-owned and ignored.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
lineIdpathYesany—

Request body (application/json)

{
  "configuration": {},
  "targetSubscriptionId": null,
  "sourceSubscriptionItemId": null
}

Responses

200Quote after the update
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote or line not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is in a terminal status
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/items/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"configuration\": {},
  \"targetSubscriptionId\": null,
  \"sourceSubscriptionItemId\": null
}"
DELETE/cpq/quotes/{quoteId}/items/{lineId}
Auth required

Remove a quote line

On an Amend / Renew quote, a line mirroring a live subscription item is not deleted: it (and its mirrored components) becomes a `cancel` line with zero totals, and activation terminates the item; lines this quote added under it are deleted. 409 when the item is already marked for removal — use `POST .../restore` to undo. Other lines are deleted with their descendants. Mutation guards run first (resource kind `cpq.quote_line`, delete).

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
lineIdpathYesany—

Responses

200Quote after the removal
Content-Type: application/json
"string"
404Quote or line not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is in a terminal status
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/items/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/items/{lineId}/restore
Auth required

Restore a removed subscription item on an Amend / Renew quote

Turns a `cancel` line that mirrors a live subscription item back into a `modify` line, rebuilt from the item (configuration, quantity, stored price). Its cancelled mirrored components are restored with it. 409 when the line is not a removed item, its parent is still removed, or the item is no longer active. Mutation guards run first (resource kind `cpq.quote_line`, update).

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
lineIdpathYesany—

Responses

200Quote after the restore
Content-Type: application/json
"string"
404Quote or line not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is in a terminal status
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/items/00000000-0000-4000-8000-000000000000/restore" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/quotes/{quoteId}/price-adjustments
Auth required

List quote price adjustments

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200Paged adjustments, pricing revision, feature state and the reason options (`reasons: [{ value, label }]`)
Content-Type: application/json
"string"
400Invalid input
Content-Type: application/json
{
  "error": "string"
}
403Missing permission or disabled feature
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Adjustment locked or stale revision
Content-Type: application/json
{
  "error": "string"
}
422Invalid adjustment or guard rejection
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/price-adjustments?page=1&pageSize=25" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/price-adjustments
Auth required

Create a negotiated quote price adjustment

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "adjustmentType": "discount_percent",
  "value": 1,
  "currencyCode": null,
  "chargeTypeFilter": null,
  "reasonCode": "string",
  "reasonNote": null,
  "level": "charge",
  "quoteLineId": "00000000-0000-4000-8000-000000000000",
  "chargeCode": null
}

Responses

201Adjustment and updated quote
Content-Type: application/json
"string"
400Invalid input
Content-Type: application/json
{
  "error": "string"
}
403Missing permission or disabled feature
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Adjustment locked or stale revision
Content-Type: application/json
{
  "error": "string"
}
422Invalid adjustment or guard rejection
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/price-adjustments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"adjustmentType\": \"discount_percent\",
  \"value\": 1,
  \"currencyCode\": null,
  \"chargeTypeFilter\": null,
  \"reasonCode\": \"string\",
  \"reasonNote\": null,
  \"level\": \"charge\",
  \"quoteLineId\": \"00000000-0000-4000-8000-000000000000\",
  \"chargeCode\": null
}"
PATCH/cpq/quotes/{quoteId}/price-adjustments/{adjustmentId}
Auth required

Update a negotiated quote price adjustment

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
adjustmentIdpathYesany—

Request body (application/json)

{
  "currencyCode": null,
  "chargeTypeFilter": null,
  "reasonNote": null
}

Responses

200Adjustment and updated quote
Content-Type: application/json
"string"
400Invalid input
Content-Type: application/json
{
  "error": "string"
}
403Missing permission or disabled feature
Content-Type: application/json
{
  "error": "string"
}
404Quote or adjustment not found
Content-Type: application/json
{
  "error": "string"
}
409Adjustment locked, stale revision or changed undo target
Content-Type: application/json
{
  "error": "string"
}
422Invalid adjustment or guard rejection
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/price-adjustments/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"currencyCode\": null,
  \"chargeTypeFilter\": null,
  \"reasonNote\": null
}"
DELETE/cpq/quotes/{quoteId}/price-adjustments/{adjustmentId}
Auth required

Remove a negotiated quote price adjustment

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
adjustmentIdpathYesany—
expectedRevisionqueryNoany—

Responses

200Updated quote
Content-Type: application/json
"string"
400Invalid input
Content-Type: application/json
{
  "error": "string"
}
403Missing permission or disabled feature
Content-Type: application/json
{
  "error": "string"
}
404Quote or adjustment not found
Content-Type: application/json
{
  "error": "string"
}
409Adjustment locked, stale revision or changed undo target
Content-Type: application/json
{
  "error": "string"
}
422Invalid adjustment or guard rejection
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/price-adjustments/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/price-adjustments/preview
Auth required

Preview a draft adjustment without saving or emitting events

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "draft": {
    "adjustmentType": "discount_percent",
    "value": 1,
    "currencyCode": null,
    "chargeTypeFilter": null,
    "reasonCode": "string",
    "reasonNote": null,
    "level": "charge",
    "quoteLineId": "00000000-0000-4000-8000-000000000000",
    "chargeCode": null
  }
}

Responses

200Draft quote and adjustment errors; nothing persisted
Content-Type: application/json
"string"
400Invalid draft
Content-Type: application/json
{
  "error": "string"
}
403Missing permission or disabled feature
Content-Type: application/json
{
  "error": "string"
}
404Quote, line or replaced adjustment not found
Content-Type: application/json
{
  "error": "string"
}
409Adjustment locked or stale revision
Content-Type: application/json
{
  "error": "string"
}
422Ineligible target or invalid reason
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/price-adjustments/preview" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"draft\": {
    \"adjustmentType\": \"discount_percent\",
    \"value\": 1,
    \"currencyCode\": null,
    \"chargeTypeFilter\": null,
    \"reasonCode\": \"string\",
    \"reasonNote\": null,
    \"level\": \"charge\",
    \"quoteLineId\": \"00000000-0000-4000-8000-000000000000\",
    \"chargeCode\": null
  }
}"
POST/cpq/quotes/{quoteId}/recalculate
Auth required

Re-price every line of a CPQ quote

Re-resolves charges and price rules. With `save: true` the result is persisted (refused on accepted, rejected and cancelled quotes) and mutation guards (resource kind `cpq.quote`, action `recalculate`) run first. Frozen Amend mirror lines keep their stored price.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "save": true
}

Responses

200Recalculated quote
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Saved recalculation on a terminal quote
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/recalculate" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"save\": true
}"
POST/cpq/quotes/{quoteId}/status
Auth required

Transition a CPQ quote to another status

Operator-driven status change. Registered mutation guards (resource kind `cpq.quote`, action `transition_status`) run first — projects use them to enforce approvals.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "targetStatus": "string"
}

Responses

200Quote with its new status
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Transition not allowed
Content-Type: application/json
{
  "error": "string"
}
422ARC validation failed or blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"targetStatus\": \"string\"
}"
GET/cpq/quotes/attributes
Auth required

List run-time attributes to configure for an offering

Returns the offering specification's run-time attributes with constraints applied against the current configuration. Requests with only `productId` (legacy) return an empty list.

Parameters

NameInRequiredSchemaDescription
offeringIdqueryNoany—
productIdqueryNoany—
configurationqueryNoanyJSON-encoded object of the attribute values selected so far

Responses

200`{ attributes }`
Content-Type: application/json
"string"
400Either offeringId or productId is required
Content-Type: application/json
{
  "error": "string"
}
404Offering not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/quotes/attributes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/validate-relationships
Auth required

Validate product relationships for a set of offerings without saving

Checks the specification relationships (requires, excludes, parent/child cardinality) between the given offerings, and returns the child specifications each parent allows with their current counts.

Request body (application/json)

{
  "offeringIds": [
    "00000000-0000-4000-8000-000000000000"
  ]
}

Responses

200`{ valid, errors, allowedChildSpecs }`
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/validate-relationships" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"offeringIds\": [
    \"00000000-0000-4000-8000-000000000000\"
  ]
}"

CPQ Bundles

Showing 9 of 9 endpoints
GET/cpq/bundle-slots
Auth required

List the slots of a bundle specification, or get one slot by id

With `id` returns a single slot; otherwise `specId` is required.

Parameters

NameInRequiredSchemaDescription
idqueryNoany—
specIdqueryNoany—

Responses

200Slot, or `{ items }` slots of the specification
Content-Type: application/json
"string"
400specId is required
Content-Type: application/json
{
  "error": "string"
}
404Slot not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/bundle-slots" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/bundle-slots
Auth required

Create a slot on a bundle specification

Request body (application/json)

{
  "specId": "00000000-0000-4000-8000-000000000000",
  "targetSpecId": "00000000-0000-4000-8000-000000000000",
  "componentGroup": "string",
  "name": "string",
  "description": null,
  "cardinalityMin": 0,
  "cardinalityMax": null,
  "sortOrder": 0,
  "metadata": null
}

Responses

201Created slot
Content-Type: application/json
"string"
400Validation error or bundle rule violation (`V-*` code)
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/bundle-slots" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"specId\": \"00000000-0000-4000-8000-000000000000\",
  \"targetSpecId\": \"00000000-0000-4000-8000-000000000000\",
  \"componentGroup\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"cardinalityMin\": 0,
  \"cardinalityMax\": null,
  \"sortOrder\": 0,
  \"metadata\": null
}"
PUT/cpq/bundle-slots
Auth required

Update a bundle slot

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "description": null,
  "cardinalityMax": null,
  "metadata": null
}

Responses

200Updated slot
Content-Type: application/json
"string"
400Validation error or bundle rule violation (`V-*` code)
Content-Type: application/json
{
  "error": "string"
}
404Slot not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/bundle-slots" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": null,
  \"cardinalityMax\": null,
  \"metadata\": null
}"
DELETE/cpq/bundle-slots
Auth required

Delete a bundle slot

Refused while active offering components still use the slot.

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Missing id, or the slot still has active offering components
Content-Type: application/json
{
  "error": "string"
}
404Slot not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/bundle-slots" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/bundle-tree
Auth required

Resolve the slot/component tree of a bundle offering

Returns the resolved bundle tree (slots with their component offerings) for a bundle offering, plus a completeness validation result (cardinality checks per slot).

Parameters

NameInRequiredSchemaDescription
offeringIdqueryYesany—

Responses

200`{ tree, validation }` for the offering
Content-Type: application/json
"string"
400offeringId is required
Content-Type: application/json
{
  "error": "string"
}
404Offering not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/bundle-tree?offeringId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/offering-components
Auth required

List the components (child offerings per slot) of a bundle offering

Parameters

NameInRequiredSchemaDescription
offeringIdqueryYesany—
slotIdqueryNoany—

Responses

200`{ items }` components of the offering
Content-Type: application/json
"string"
400offeringId is required
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/offering-components?offeringId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/offering-components
Auth required

Add a child offering to a slot of a bundle offering

Request body (application/json)

{
  "offeringId": "00000000-0000-4000-8000-000000000000",
  "slotId": "00000000-0000-4000-8000-000000000000",
  "childOfferingId": "00000000-0000-4000-8000-000000000000",
  "isDefault": false,
  "sortOrder": 0,
  "metadata": null
}

Responses

201Created component
Content-Type: application/json
"string"
400Validation error or bundle rule violation (`V-*` code)
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/offering-components" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"offeringId\": \"00000000-0000-4000-8000-000000000000\",
  \"slotId\": \"00000000-0000-4000-8000-000000000000\",
  \"childOfferingId\": \"00000000-0000-4000-8000-000000000000\",
  \"isDefault\": false,
  \"sortOrder\": 0,
  \"metadata\": null
}"
PUT/cpq/offering-components
Auth required

Update a bundle offering component

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "metadata": null
}

Responses

200Updated component
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/offering-components" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"metadata\": null
}"
DELETE/cpq/offering-components
Auth required

Remove a component from a bundle offering

Request body (application/json)

{
  "id": "string"
}

Responses

200Removed
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/offering-components" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"

CPQ Inventory

Showing 16 of 16 endpoints
GET/cpq/inventory/assets
Auth required

List customer assets in CPQ inventory, or get one by id

With `id` returns a single asset; otherwise a paged list.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
customerIdqueryNoany—
statusqueryNoany—
assetTypequeryNoany—
productIdqueryNoany—
subscriptionIdqueryNoany—
subscriptionItemIdqueryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Asset, or paged list of assets
Content-Type: application/json
"string"
404Asset not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/assets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/inventory/assets
Auth required

Create an asset in CPQ inventory

Request body (application/json)

{
  "customerId": "00000000-0000-4000-8000-000000000000",
  "subscriptionId": null,
  "subscriptionItemId": null,
  "productId": null,
  "offeringId": null,
  "specId": null,
  "name": "string",
  "description": null,
  "assetType": "one_time",
  "purchasePrice": 0,
  "quantity": 1,
  "purchaseDate": null,
  "deliveryDate": null,
  "configuration": {},
  "charges": null,
  "sourceQuoteId": null,
  "sourceOrderId": null,
  "sourceQuoteLineId": null,
  "metadata": null
}

Responses

201Created asset
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Linked subscription or item not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/inventory/assets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"customerId\": \"00000000-0000-4000-8000-000000000000\",
  \"subscriptionId\": null,
  \"subscriptionItemId\": null,
  \"productId\": null,
  \"offeringId\": null,
  \"specId\": null,
  \"name\": \"string\",
  \"description\": null,
  \"assetType\": \"one_time\",
  \"purchasePrice\": 0,
  \"quantity\": 1,
  \"purchaseDate\": null,
  \"deliveryDate\": null,
  \"configuration\": {},
  \"charges\": null,
  \"sourceQuoteId\": null,
  \"sourceOrderId\": null,
  \"sourceQuoteLineId\": null,
  \"metadata\": null
}"
PUT/cpq/inventory/assets
Auth required

Update an asset in CPQ inventory

Status changes go through `POST /api/cpq/inventory/assets/status`.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "description": null,
  "deliveryDate": null,
  "metadata": null
}

Responses

200Updated asset
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Asset not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/inventory/assets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": null,
  \"deliveryDate\": null,
  \"metadata\": null
}"
DELETE/cpq/inventory/assets
Auth required

Delete an asset from CPQ inventory

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Missing id
Content-Type: application/json
{
  "error": "string"
}
404Asset not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/inventory/assets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
POST/cpq/inventory/assets/status
Auth required

Transition an inventory asset to another status

Validates the transition against the asset state machine.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "targetStatus": "string"
}

Responses

200Asset with its new status
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Asset not found
Content-Type: application/json
{
  "error": "string"
}
409Transition not allowed
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/inventory/assets/status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"targetStatus\": \"string\"
}"
GET/cpq/inventory/customer/{customerId}
Auth required

Get the installed base (subscriptions and assets) of a customer

Terminated records are excluded unless `includeTerminated=true`.

Parameters

NameInRequiredSchemaDescription
customerIdpathYesany—
statusqueryNoany—
productIdqueryNoany—
includeTerminatedqueryNoany—

Responses

200Customer inventory
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/customer/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/inventory/customer/{customerId}/parent-items
Auth required

List subscription items of a customer that can act as parents for add-ons

Used when configuring a child line on a quote that must attach to an item the customer already owns.

Parameters

NameInRequiredSchemaDescription
customerIdpathYesany—
productIdqueryNoany—
offeringIdqueryNoany—

Responses

200Candidate parent items
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/customer/00000000-0000-4000-8000-000000000000/parent-items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/inventory/subscription-items
Auth required

List the items of a subscription, or the children of a parent item

At least one of `subscriptionId` or `parentItemId` is required.

Parameters

NameInRequiredSchemaDescription
subscriptionIdqueryNoany—
parentItemIdqueryNoany—
statusqueryNoany—

Responses

200Subscription items
Content-Type: application/json
"string"
400At least one of subscriptionId or parentItemId is required
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/subscription-items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/inventory/subscription-items
Auth required

Add an item to a subscription in CPQ inventory

Request body (application/json)

{
  "subscriptionId": "00000000-0000-4000-8000-000000000000",
  "parentItemId": null,
  "productId": null,
  "offeringId": null,
  "specId": null,
  "name": "string",
  "configuration": {},
  "charges": null,
  "mrcAmount": 0,
  "nrcAmount": 0,
  "quantity": 1,
  "capacityTotal": null,
  "capacityUnit": null,
  "sourceQuoteLineId": null,
  "metadata": null,
  "sortOrder": 0
}

Responses

201Created subscription item
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Subscription or parent item not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/inventory/subscription-items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"subscriptionId\": \"00000000-0000-4000-8000-000000000000\",
  \"parentItemId\": null,
  \"productId\": null,
  \"offeringId\": null,
  \"specId\": null,
  \"name\": \"string\",
  \"configuration\": {},
  \"charges\": null,
  \"mrcAmount\": 0,
  \"nrcAmount\": 0,
  \"quantity\": 1,
  \"capacityTotal\": null,
  \"capacityUnit\": null,
  \"sourceQuoteLineId\": null,
  \"metadata\": null,
  \"sortOrder\": 0
}"
PUT/cpq/inventory/subscription-items
Auth required

Update a subscription item in CPQ inventory

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "metadata": null,
  "capacityTotal": null,
  "capacityUsed": null,
  "capacityUnit": null
}

Responses

200Updated subscription item
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Item not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/inventory/subscription-items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"metadata\": null,
  \"capacityTotal\": null,
  \"capacityUsed\": null,
  \"capacityUnit\": null
}"
DELETE/cpq/inventory/subscription-items
Auth required

Delete a subscription item from CPQ inventory

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Missing id
Content-Type: application/json
{
  "error": "string"
}
404Item not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/inventory/subscription-items" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/inventory/subscriptions
Auth required

List customer subscriptions in CPQ inventory, or get one by id

With `id` returns a single subscription; otherwise a paged list. `status` accepts a comma-separated list. `expiringWithinDays` (1 to 365) keeps subscriptions whose current term ends within that window.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
customerIdqueryNoany—
statusqueryNoany—
productIdqueryNoany—
sourceOrderIdqueryNoany—
billingCyclequeryNoany—
searchqueryNoany—
expiringWithinDaysqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Subscription, or paged list of subscriptions
Content-Type: application/json
"string"
404Subscription not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/inventory/subscriptions
Auth required

Create a subscription in CPQ inventory

Manual creation. Subscriptions are normally provisioned by order activation.

Request body (application/json)

{
  "customerId": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "description": null,
  "billingCycle": "monthly",
  "startDate": null,
  "termMonths": null,
  "autoRenew": true,
  "sourceQuoteId": null,
  "sourceOrderId": null,
  "metadata": null,
  "items": [
    {
      "parentItemId": null,
      "productId": null,
      "offeringId": null,
      "specId": null,
      "name": "string",
      "configuration": {},
      "charges": null,
      "mrcAmount": 0,
      "nrcAmount": 0,
      "quantity": 1,
      "capacityTotal": null,
      "capacityUnit": null,
      "sourceQuoteLineId": null,
      "metadata": null,
      "sortOrder": 0
    }
  ]
}

Responses

201Created subscription
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"customerId\": \"00000000-0000-4000-8000-000000000000\",
  \"name\": \"string\",
  \"description\": null,
  \"billingCycle\": \"monthly\",
  \"startDate\": null,
  \"termMonths\": null,
  \"autoRenew\": true,
  \"sourceQuoteId\": null,
  \"sourceOrderId\": null,
  \"metadata\": null,
  \"items\": [
    {
      \"parentItemId\": null,
      \"productId\": null,
      \"offeringId\": null,
      \"specId\": null,
      \"name\": \"string\",
      \"configuration\": {},
      \"charges\": null,
      \"mrcAmount\": 0,
      \"nrcAmount\": 0,
      \"quantity\": 1,
      \"capacityTotal\": null,
      \"capacityUnit\": null,
      \"sourceQuoteLineId\": null,
      \"metadata\": null,
      \"sortOrder\": 0
    }
  ]
}"
PUT/cpq/inventory/subscriptions
Auth required

Update a subscription in CPQ inventory

Status changes go through `POST /api/cpq/inventory/subscriptions/status`.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "description": null,
  "termMonths": null,
  "currentTermEnd": null,
  "metadata": null
}

Responses

200Updated subscription
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Subscription not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": null,
  \"termMonths\": null,
  \"currentTermEnd\": null,
  \"metadata\": null
}"
DELETE/cpq/inventory/subscriptions
Auth required

Delete a subscription from CPQ inventory

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Missing id
Content-Type: application/json
{
  "error": "string"
}
404Subscription not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
POST/cpq/inventory/subscriptions/status
Auth required

Transition an inventory subscription to another status

Validates the transition against the subscription state machine. Non-terminal items follow the new status, and linked assets are activated or cancelled accordingly.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "targetStatus": "string"
}

Responses

200Subscription with its new status
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Subscription not found
Content-Type: application/json
{
  "error": "string"
}
409Transition not allowed
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions/status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"targetStatus\": \"string\"
}"

CPQ ARC

Showing 9 of 9 endpoints
GET/cpq/inventory/subscriptions/{subscriptionId}/change-log
Auth required

List the ARC change-log timeline of a subscription

Paginated history of ARC changes applied to the subscription, most recent first.

Parameters

NameInRequiredSchemaDescription
subscriptionIdpathYesany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200Paginated change-log entries
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions/00000000-0000-4000-8000-000000000000/change-log?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/cpq/inventory/subscriptions/expiring
Auth required

List subscriptions whose current term ends within N days

Drives renewal triage. Defaults: `withinDays=30`, `status=active`.

Parameters

NameInRequiredSchemaDescription
withinDaysqueryNoany—
customerIdqueryNoany—
billingCyclequeryNoany—
statusqueryNoany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200Paginated subscriptions
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/inventory/subscriptions/expiring?withinDays=30&status=active&page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/cancel-meta
Auth required

Set cancellation reason and early termination fee (ETF) on a cancel quote

Required on a `quoteType=cancel` quote before it can move through the approval lifecycle.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "reasonCode": "upgrade",
  "reasonText": null,
  "etfAmount": null,
  "etfCurrency": null
}

Responses

200Quote with the cancel meta stamped
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is not a cancel quote or is no longer editable
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/cancel-meta" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"reasonCode\": \"upgrade\",
  \"reasonText\": null,
  \"etfAmount\": null,
  \"etfCurrency\": null
}"
POST/cpq/quotes/{quoteId}/merge-meta
Auth required

Set the new contract term and optional code/name on a merge-renew quote

For a `quoteType=renew` quote that merges two or more subscriptions (absorb targets) into one. Required before activation.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "newTermStart": "string",
  "newTermEnd": "string",
  "newSubCode": null,
  "newSubName": null
}

Responses

200Quote with the merge meta stamped
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Quote is not a renew quote or is no longer editable
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/merge-meta" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"newTermStart\": \"string\",
  \"newTermEnd\": \"string\",
  \"newSubCode\": null,
  \"newSubName\": null
}"
GET/cpq/quotes/{quoteId}/target-subscriptions
Auth required

List the subscriptions an ARC quote targets

Each target includes its context (current items and term).

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Responses

200`{ items }` attached targets
Content-Type: application/json
"string"
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/target-subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/{quoteId}/target-subscriptions
Auth required

Attach a subscription as a target of an ARC quote

Supports multi-target quotes. For renew quotes `mergeAction=absorb` merges the subscription into the renewal. The subscription must share the quote customer and currency.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—

Request body (application/json)

{
  "subscriptionId": "00000000-0000-4000-8000-000000000000",
  "quoteType": "amend"
}

Responses

201Target attached
Content-Type: application/json
"string"
400Validation error, or subscription customer or currency does not match the quote
Content-Type: application/json
{
  "error": "string"
}
404Quote or subscription not found
Content-Type: application/json
{
  "error": "string"
}
409Quote type is `new`, quote no longer editable, or concurrent modification detected
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/target-subscriptions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"subscriptionId\": \"00000000-0000-4000-8000-000000000000\",
  \"quoteType\": \"amend\"
}"
PATCH/cpq/quotes/{quoteId}/target-subscriptions/{targetId}
Auth required

Update an ARC quote target (mergeAction or renewal term)

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
targetIdpathYesany—

Request body (application/json)

{
  "newTermStart": null,
  "newTermEnd": null,
  "newTermMonths": null
}

Responses

200Updated target
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote or target not found
Content-Type: application/json
{
  "error": "string"
}
409Quote no longer editable
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/target-subscriptions/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"newTermStart\": null,
  \"newTermEnd\": null,
  \"newTermMonths\": null
}"
DELETE/cpq/quotes/{quoteId}/target-subscriptions/{targetId}
Auth required

Detach a target subscription from an ARC quote

Also drops the quote lines that belong to that target.

Parameters

NameInRequiredSchemaDescription
quoteIdpathYesany—
targetIdpathYesany—

Responses

200Target detached
Content-Type: application/json
"string"
404Quote or target not found
Content-Type: application/json
{
  "error": "string"
}
409Quote no longer editable
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/quotes/00000000-0000-4000-8000-000000000000/target-subscriptions/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/quotes/from-subscription
Auth required

Create an ARC (amend, renew or cancel) quote pre-filled from a subscription

Creates a new quote of the given ARC type with the subscription's current items as lines. `renewTerm` sets the new contract term for renewals. The subscription must be active or suspended.

Request body (application/json)

{
  "subscriptionId": "00000000-0000-4000-8000-000000000000",
  "type": "amend"
}

Responses

201Quote created
Content-Type: application/json
{
  "quoteId": "string",
  "cpqConfigId": "string"
}
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Subscription not found
Content-Type: application/json
{
  "error": "string"
}
409Subscription not active or suspended, or concurrent modification detected
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/from-subscription" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"subscriptionId\": \"00000000-0000-4000-8000-000000000000\",
  \"type\": \"amend\"
}"

CPQ Orders

Showing 5 of 5 endpoints
GET/cpq/orders
Auth required

List CPQ orders

Parameters

NameInRequiredSchemaDescription
customerIdqueryNoany—
sourceQuoteIdqueryNoany—
salesOrderIdqueryNoany—
cpqStatusqueryNoany—
currencyCodequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
pagequeryNoany—
pageSizequeryNoany—

Responses

200Paged list of CPQ orders
Content-Type: application/json
"string"

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/orders" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/orders
Auth required

Convert a CPQ quote into an order

Creates the sales order and CPQ order configuration from the quote. Refused for cancelled or rejected quotes; mutation guards (resource kind `cpq.quote`, action `convert_to_order`) run first.

Request body (application/json)

{
  "quoteId": "00000000-0000-4000-8000-000000000000"
}

Responses

201Created order
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Quote not found
Content-Type: application/json
{
  "error": "string"
}
409Quote cannot be converted in its status or is already converted
Content-Type: application/json
{
  "error": "string"
}
422Quote has no lines or has invalid stored adjustments, or blocked by a mutation guard
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/orders" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"quoteId\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/cpq/orders/{orderId}
Auth required

Get a CPQ order with its lines and pricing summary

`pricingSummary` carries NRC / MRC totals plus the source quote's waterfall figures (`listNrcTotal`, `listMrcTotal`, `standard*Total`, `ruleDiscountTotal`, `manualDiscountTotal`, `dealValue`, `discountDepth`), computed from the line charges copied at conversion. ARC lines carry `arcSource` (the subscription item before the change).

Parameters

NameInRequiredSchemaDescription
orderIdpathYesany—

Responses

200The order
Content-Type: application/json
"string"
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Order not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/orders/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/orders/{orderId}/activate
Auth required

Activate a CPQ order and provision customer inventory

Moves a `draft` / `pending_activation` order to `active` and creates or updates the customer subscriptions and assets: a new-sale order creates its subscription, an ARC order (amend / renew / cancel) applies its changes to the target subscriptions; lifecycle events fire after commit. Registered mutation guards run first (resource kind `cpq.order`, operation `update`, payload `{ action: "activate", orderId }`). A guard that blocks returns its own status and body, typically 422 `{ error, code, ...details }` — add-on packages use this to enforce rules CPQ does not own (e.g. no activation before a date). A concurrent activation touching the same subscription returns 409 and the order stays retryable.

Parameters

NameInRequiredSchemaDescription
orderIdpathYesany—

Responses

200Activated order
Content-Type: application/json
"string"
400No organization selected
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Order not found
Content-Type: application/json
{
  "error": "string"
}
409Order cannot be activated in its status, or concurrent modification detected
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard (body passed through from the guard: `error`, usually `code` and details)
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/orders/00000000-0000-4000-8000-000000000000/activate" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/orders/{orderId}/status
Auth required

Transition a CPQ order to another status

Operator-driven order lifecycle change, validated against the order state machine. Transitioning to `active` runs the same activation as the activate endpoint, including its mutation guards (resource kind `cpq.order`, operation `update`, payload `{ action: "activate", orderId, targetStatus }`); other transitions run the guards with `action: "transition"`. A blocking guard returns its own status and body.

Parameters

NameInRequiredSchemaDescription
orderIdpathYesany—

Request body (application/json)

{
  "targetStatus": "string"
}

Responses

200Order with its new status
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
404Order not found
Content-Type: application/json
{
  "error": "string"
}
409Transition not allowed
Content-Type: application/json
{
  "error": "string"
}
422Blocked by a mutation guard (body passed through from the guard)
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/orders/00000000-0000-4000-8000-000000000000/status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"targetStatus\": \"string\"
}"

CPQ Pricing

Showing 13 of 13 endpoints
GET/cpq/price-rules
Auth required

List CPQ price rules (discounts, surcharges, price overrides), or get one by id

With `id` returns a single rule. Otherwise a paged list (default sort sortOrder asc), each row with `productOfferingName`. `globalOnly=true` keeps rules not bound to an offering; `search` matches code, name or description.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
productOfferingIdqueryNoany—
globalOnlyqueryNoany—
ruleTypequeryNoany—
chargeTypeFilterqueryNoany—
isActivequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Price rule, or paged list of price rules
Content-Type: application/json
"string"
404Price rule not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/price-rules" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/price-rules
Auth required

Create a CPQ price rule

Request body (application/json)

{
  "code": "string",
  "name": "string",
  "description": null,
  "productOfferingId": null,
  "ruleType": "discount_percent",
  "value": 1,
  "chargeCodeFilter": null,
  "chargeTypeFilter": null,
  "applicabilityCondition": null,
  "sortOrder": 0,
  "isActive": true
}

Responses

201Created price rule
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/price-rules" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"productOfferingId\": null,
  \"ruleType\": \"discount_percent\",
  \"value\": 1,
  \"chargeCodeFilter\": null,
  \"chargeTypeFilter\": null,
  \"applicabilityCondition\": null,
  \"sortOrder\": 0,
  \"isActive\": true
}"
PUT/cpq/price-rules
Auth required

Update a CPQ price rule

Request body (application/json)

{
  "description": null,
  "productOfferingId": null,
  "chargeCodeFilter": null,
  "chargeTypeFilter": null,
  "applicabilityCondition": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated price rule
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/price-rules" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"description\": null,
  \"productOfferingId\": null,
  \"chargeCodeFilter\": null,
  \"chargeTypeFilter\": null,
  \"applicabilityCondition\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/price-rules
Auth required

Soft-delete a CPQ price rule

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/price-rules" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/pricing-table-entries
Auth required

List the price rows of a pricing table

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
pricingTableIdqueryYesany—

Responses

200`{ items, total, page, pageSize, totalPages }`
Content-Type: application/json
"string"
400pricingTableId is required and must be a valid UUID
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/pricing-table-entries?pricingTableId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/pricing-table-entries
Auth required

Create one pricing table entry, or several in bulk

Accepts a single entry object (returns the entry) or an array of entries (returns `{ items }`).

Request body (application/json)

{
  "pricingTableId": "00000000-0000-4000-8000-000000000000",
  "dimensionValues": {
    "key": "string"
  },
  "tierNumber": null,
  "rangeFrom": null,
  "rangeTo": null,
  "currencyCode": "USD",
  "prices": {
    "key": 1
  },
  "isActive": true
}

Responses

201Created entry, or `{ items }` for a bulk create
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/pricing-table-entries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"pricingTableId\": \"00000000-0000-4000-8000-000000000000\",
  \"dimensionValues\": {
    \"key\": \"string\"
  },
  \"tierNumber\": null,
  \"rangeFrom\": null,
  \"rangeTo\": null,
  \"currencyCode\": \"USD\",
  \"prices\": {
    \"key\": 1
  },
  \"isActive\": true
}"
PUT/cpq/pricing-table-entries
Auth required

Update a pricing table entry

Request body (application/json)

{
  "tierNumber": null,
  "rangeFrom": null,
  "rangeTo": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated entry
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/pricing-table-entries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"tierNumber\": null,
  \"rangeFrom\": null,
  \"rangeTo\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/pricing-table-entries
Auth required

Soft-delete a pricing table entry

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/pricing-table-entries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/pricing-tables
Auth required

List CPQ pricing tables, or get one by id with all its entries

A pricing table is a price matrix keyed by dimensions (attribute values) with one or more price columns. With `id` returns the table plus its entries; otherwise a paged list without entries. `search` matches code or name.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
codequeryNoany—
isActivequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Pricing table with entries, or paged list of pricing tables
Content-Type: application/json
"string"
404Pricing table not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/pricing-tables" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/pricing-tables
Auth required

Create a CPQ pricing table

Request body (application/json)

{
  "code": "string",
  "name": "string",
  "dimensions": [
    {
      "key": "string",
      "label": "string"
    }
  ],
  "priceColumns": [
    {
      "key": "string",
      "label": "string"
    }
  ],
  "currencyCodeList": [
    "string"
  ],
  "isActive": true
}

Responses

201Created pricing table
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/pricing-tables" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"name\": \"string\",
  \"dimensions\": [
    {
      \"key\": \"string\",
      \"label\": \"string\"
    }
  ],
  \"priceColumns\": [
    {
      \"key\": \"string\",
      \"label\": \"string\"
    }
  ],
  \"currencyCodeList\": [
    \"string\"
  ],
  \"isActive\": true
}"
PUT/cpq/pricing-tables
Auth required

Update a CPQ pricing table definition

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated pricing table
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/pricing-tables" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/pricing-tables
Auth required

Soft-delete a CPQ pricing table

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/pricing-tables" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
POST/cpq/quotes/price
Auth required

Calculate catalog prices and price rules without saving

Manual quote adjustments are never applied. Set includeWaterfall=true to return list and standard prices; these fields are omitted by default.

Request body (application/json)

{
  "includeWaterfall": false,
  "primaryItem": null,
  "childItems": [
    {
      "offeringId": null,
      "productId": null,
      "configuration": {}
    }
  ]
}

Responses

200Resolved rule prices and optional waterfall
Content-Type: application/json
{
  "primaryCharges": [
    {
      "chargeCode": "string",
      "chargeName": "string",
      "chargeType": "nrc",
      "pricingMethod": "flat",
      "currencyCode": "string",
      "unitPrice": 1,
      "quantity": null,
      "totalPrice": null,
      "listTotalPrice": null,
      "standardTotalPrice": null,
      "adjustments": null
    }
  ],
  "childItems": [
    {
      "offeringId": null,
      "productId": null,
      "charges": [
        {
          "chargeCode": "string",
          "chargeName": "string",
          "chargeType": "nrc",
          "pricingMethod": "flat",
          "currencyCode": "string",
          "unitPrice": 1,
          "quantity": null,
          "totalPrice": null,
          "listTotalPrice": null,
          "standardTotalPrice": null,
          "adjustments": null
        }
      ]
    }
  ],
  "totals": {
    "nrcTotal": 1,
    "mrcTotal": 1,
    "usageCharges": []
  },
  "currencyCode": "string"
}
400Invalid pricing request
Content-Type: application/json
{
  "error": "string"
}
500Price calculation failed
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/quotes/price" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"includeWaterfall\": false,
  \"primaryItem\": null,
  \"childItems\": [
    {
      \"offeringId\": null,
      \"productId\": null,
      \"configuration\": {}
    }
  ]
}"

CPQ Products

Showing 20 of 20 endpoints
GET/cpq/product-attributes
Auth required

List configurable attributes of a product or specification

Ordered by sortOrder. Each attribute has a `resolutionTime` of design_time (fixed per offering) or run_time (chosen when quoting).

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
productIdqueryNoany—
specIdqueryNoany—

Responses

200`{ items, total, page, pageSize, totalPages }`
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/product-attributes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/product-attributes
Auth required

Create a product attribute

`productId` is derived from `specId` when omitted.

Request body (application/json)

{
  "specId": null,
  "code": "string",
  "name": "string",
  "attributeType": "enum",
  "resolutionTime": "run_time",
  "options": null,
  "constraints": null,
  "referenceEntity": null,
  "referenceFilter": null,
  "dependsOn": null,
  "defaultValue": null,
  "helpText": null,
  "sortOrder": 0,
  "isRequired": true,
  "isActive": true
}

Responses

201Created attribute
Content-Type: application/json
"string"
400Validation error, or neither productId nor a valid specId given
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/product-attributes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"specId\": null,
  \"code\": \"string\",
  \"name\": \"string\",
  \"attributeType\": \"enum\",
  \"resolutionTime\": \"run_time\",
  \"options\": null,
  \"constraints\": null,
  \"referenceEntity\": null,
  \"referenceFilter\": null,
  \"dependsOn\": null,
  \"defaultValue\": null,
  \"helpText\": null,
  \"sortOrder\": 0,
  \"isRequired\": true,
  \"isActive\": true
}"
PUT/cpq/product-attributes
Auth required

Update a product attribute

Request body (application/json)

{
  "specId": null,
  "options": null,
  "constraints": null,
  "referenceEntity": null,
  "referenceFilter": null,
  "dependsOn": null,
  "defaultValue": null,
  "helpText": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated attribute
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/product-attributes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"specId\": null,
  \"options\": null,
  \"constraints\": null,
  \"referenceEntity\": null,
  \"referenceFilter\": null,
  \"dependsOn\": null,
  \"defaultValue\": null,
  \"helpText\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/product-attributes
Auth required

Soft-delete a product attribute

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/product-attributes" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/product-charges
Auth required

List the charges (price components) of a product or offering

Ordered by sortOrder. A charge is priced either from a fixed price or from a pricing table column.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
productIdqueryNoany—
offeringIdqueryNoany—

Responses

200`{ items, total, page, pageSize, totalPages }`
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/product-charges" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/product-charges
Auth required

Create a product charge

`productId` is derived from `offeringId` (via the offering's specification) when omitted. A legacy combined `pricingMethod` is normalized into `chargeModel` plus `pricingMethod` (fixed or table).

Request body (application/json)

{
  "offeringId": null,
  "code": "string",
  "name": "string",
  "description": null,
  "chargeType": "nrc",
  "pricingMethod": "fixed",
  "pricingTableId": null,
  "priceColumnKey": null,
  "fixedPrice": null,
  "currencyCode": null,
  "quantityAttributeCode": null,
  "applicabilityCondition": null,
  "sortOrder": 0,
  "isActive": true
}

Responses

201Created charge
Content-Type: application/json
"string"
400Validation error, or neither productId nor a valid offeringId given
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/product-charges" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"offeringId\": null,
  \"code\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"chargeType\": \"nrc\",
  \"pricingMethod\": \"fixed\",
  \"pricingTableId\": null,
  \"priceColumnKey\": null,
  \"fixedPrice\": null,
  \"currencyCode\": null,
  \"quantityAttributeCode\": null,
  \"applicabilityCondition\": null,
  \"sortOrder\": 0,
  \"isActive\": true
}"
PUT/cpq/product-charges
Auth required

Update a product charge

Changing `pricingMethod` or `chargeModel` re-normalizes the charge and clears the fields of the other pricing source (fixedPrice vs pricingTableId and priceColumnKey).

Request body (application/json)

{
  "offeringId": null,
  "description": null,
  "pricingTableId": null,
  "priceColumnKey": null,
  "fixedPrice": null,
  "currencyCode": null,
  "quantityAttributeCode": null,
  "applicabilityCondition": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated charge
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/product-charges" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"offeringId\": null,
  \"description\": null,
  \"pricingTableId\": null,
  \"priceColumnKey\": null,
  \"fixedPrice\": null,
  \"currencyCode\": null,
  \"quantityAttributeCode\": null,
  \"applicabilityCondition\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/product-charges
Auth required

Soft-delete a product charge

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/product-charges" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/product-offerings
Auth required

List sellable CPQ product offerings, or get one by id with its specification and charges

With `id` returns the offering plus its specification, charges and (for bundles) components with slots and child offerings. Otherwise a paged list with charges per offering; `search` matches code, name or description.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
specIdqueryNoany—
lifecycleStatusqueryNoany—
codequeryNoany—
offeringTypequeryNoany—
isActivequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Offering detail, or paged list of offerings
Content-Type: application/json
"string"
404Offering not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/product-offerings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/product-offerings
Auth required

Create a CPQ product offering for a specification

`offeringType` must match the specification's `specType` (V-OFF-7).

Request body (application/json)

{
  "specId": "00000000-0000-4000-8000-000000000000",
  "catalogOfferId": null,
  "code": "string",
  "name": "string",
  "description": null,
  "offeringType": "simple",
  "designTimeValues": {},
  "lifecycleStatus": "draft",
  "effectiveFrom": null,
  "effectiveTo": null,
  "metadata": null,
  "isActive": true
}

Responses

201Created offering
Content-Type: application/json
"string"
400Validation error, specification not found, or offeringType does not match specType
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/product-offerings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"specId\": \"00000000-0000-4000-8000-000000000000\",
  \"catalogOfferId\": null,
  \"code\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"offeringType\": \"simple\",
  \"designTimeValues\": {},
  \"lifecycleStatus\": \"draft\",
  \"effectiveFrom\": null,
  \"effectiveTo\": null,
  \"metadata\": null,
  \"isActive\": true
}"
PUT/cpq/product-offerings
Auth required

Update a CPQ product offering

Request body (application/json)

{
  "catalogOfferId": null,
  "description": null,
  "effectiveFrom": null,
  "effectiveTo": null,
  "metadata": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated offering
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/product-offerings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"catalogOfferId\": null,
  \"description\": null,
  \"effectiveFrom\": null,
  \"effectiveTo\": null,
  \"metadata\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/product-offerings
Auth required

Soft-delete a CPQ product offering

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/product-offerings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/product-relationships
Auth required

List relationships between product specifications

Relationships (requires, excludes, parent_child) drive quote line validation and allowed child products.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
sourceSpecIdqueryNoany—
targetSpecIdqueryNoany—
relationshipTypequeryNoany—

Responses

200`{ items, total, page, pageSize, totalPages }`
Content-Type: application/json
"string"
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/product-relationships" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/product-relationships
Auth required

Create a relationship between two product specifications

Request body (application/json)

{
  "sourceSpecId": "00000000-0000-4000-8000-000000000000",
  "targetSpecId": "00000000-0000-4000-8000-000000000000",
  "relationshipType": "parent_child",
  "cardinalityMin": 0,
  "cardinalityMax": null,
  "condition": null,
  "metadata": null,
  "isActive": true
}

Responses

201Created relationship
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/product-relationships" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"sourceSpecId\": \"00000000-0000-4000-8000-000000000000\",
  \"targetSpecId\": \"00000000-0000-4000-8000-000000000000\",
  \"relationshipType\": \"parent_child\",
  \"cardinalityMin\": 0,
  \"cardinalityMax\": null,
  \"condition\": null,
  \"metadata\": null,
  \"isActive\": true
}"
PUT/cpq/product-relationships
Auth required

Update a product specification relationship

Request body (application/json)

{
  "cardinalityMax": null,
  "condition": null,
  "metadata": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated relationship
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/product-relationships" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"cardinalityMax\": null,
  \"condition\": null,
  \"metadata\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/product-relationships
Auth required

Soft-delete a product specification relationship

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/product-relationships" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/product-specifications
Auth required

List CPQ product specifications, or get one by id with its related records

With `id` returns the specification plus its attributes, offerings, relationships and (for bundles) slots with their target specifications. Otherwise a paged list; `search` matches code, name or description.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
productIdqueryNoany—
lifecycleStatusqueryNoany—
codequeryNoany—
specTypequeryNoany—
isActivequeryNoany—
isAssetizablequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Specification detail, or paged list of specifications
Content-Type: application/json
"string"
404Specification not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/product-specifications" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/product-specifications
Auth required

Create a CPQ product specification

When `productId` is omitted, a configurable catalog product is reused (matched by handle or SKU derived from `code`) or created.

Request body (application/json)

{
  "code": "string",
  "name": "string",
  "description": null,
  "specType": "simple",
  "isAssetizable": false,
  "lifecycleStatus": "draft",
  "version": 1,
  "effectiveFrom": null,
  "effectiveTo": null,
  "metadata": null,
  "isActive": true
}

Responses

201Created specification
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/product-specifications" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"specType\": \"simple\",
  \"isAssetizable\": false,
  \"lifecycleStatus\": \"draft\",
  \"version\": 1,
  \"effectiveFrom\": null,
  \"effectiveTo\": null,
  \"metadata\": null,
  \"isActive\": true
}"
PUT/cpq/product-specifications
Auth required

Update a CPQ product specification

Request body (application/json)

{
  "description": null,
  "effectiveFrom": null,
  "effectiveTo": null,
  "metadata": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated specification
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/product-specifications" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"description\": null,
  \"effectiveFrom\": null,
  \"effectiveTo\": null,
  \"metadata\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/product-specifications
Auth required

Soft-delete a CPQ product specification

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/product-specifications" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"

CPQ Wizards

Showing 5 of 5 endpoints
GET/cpq/wizards
Auth required

List CPQ quoting wizard definitions, or get one by id or code

With `id` or `code` returns a single definition; otherwise a paged list.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
idqueryNoany—
codequeryNoany—
surfacequeryNoany—
isActivequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—

Responses

200Wizard definition, or paged list of definitions
Content-Type: application/json
"string"
404Wizard definition not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/wizards" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/cpq/wizards
Auth required

Create a CPQ wizard definition

Request body (application/json)

{
  "code": "string",
  "name": "string",
  "description": null,
  "steps": [
    {
      "stepId": "string",
      "type": "string",
      "title": "string",
      "description": null,
      "config": {},
      "transitions": [],
      "isOptional": false
    }
  ],
  "applicability": null,
  "paramsSchema": null,
  "surface": "backend",
  "isActive": true,
  "metadata": null
}

Responses

201Created wizard definition
Content-Type: application/json
"string"
400Validation error
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/cpq/wizards" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"code\": \"string\",
  \"name\": \"string\",
  \"description\": null,
  \"steps\": [
    {
      \"stepId\": \"string\",
      \"type\": \"string\",
      \"title\": \"string\",
      \"description\": null,
      \"config\": {},
      \"transitions\": [],
      \"isOptional\": false
    }
  ],
  \"applicability\": null,
  \"paramsSchema\": null,
  \"surface\": \"backend\",
  \"isActive\": true,
  \"metadata\": null
}"
PUT/cpq/wizards
Auth required

Update a CPQ wizard definition

Request body (application/json)

{
  "description": null,
  "applicability": null,
  "paramsSchema": null,
  "metadata": null,
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Updated wizard definition
Content-Type: application/json
"string"
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/cpq/wizards" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"description\": null,
  \"applicability\": null,
  \"paramsSchema\": null,
  \"metadata\": null,
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/cpq/wizards
Auth required

Delete a CPQ wizard definition

Request body (application/json)

{
  "id": "string"
}

Responses

200Deleted
Content-Type: application/json
{
  "success": true
}
400Validation error or missing id
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/cpq/wizards" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"string\"
}"
GET/cpq/wizards/resolve
Auth required

Resolve which wizard definition applies to a quoting context

Picks the best-matching active wizard for the surface and optional specification, offering and customer segment.

Parameters

NameInRequiredSchemaDescription
surfacequeryYesany—
specCodequeryNoany—
offeringCodequeryNoany—
customerSegmentqueryNoany—

Responses

200Resolved wizard definition
Content-Type: application/json
"string"
400Missing or invalid surface parameter
Content-Type: application/json
{
  "error": "string"
}
404No matching wizard
Content-Type: application/json
{
  "error": "string"
}
500Internal error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/cpq/wizards/resolve?surface=backend" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Customers

Showing 20 of 103 endpoints
GET/customers/activities
Auth required

List activitys

Returns a paginated collection of activitys scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
entityIdqueryNoany—
dealIdqueryNoany—
activityTypequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated activitys
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "activityType": "string",
      "subject": null,
      "body": null,
      "occurredAt": null,
      "createdAt": "string",
      "appearanceIcon": null,
      "appearanceColor": null,
      "entityId": null,
      "authorUserId": null,
      "authorName": null,
      "authorEmail": null,
      "dealId": null,
      "dealTitle": null,
      "customValues": null,
      "activityTypeLabel": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/activities?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/customers/activities
Auth required

Create activity

DEPRECATED (sunset 2026-06-30): Creates a timeline activity. Use POST /api/customers/interactions instead.

Request body (application/json)

{
  "entityId": "00000000-0000-4000-8000-000000000000",
  "activityType": "string",
  "date": null,
  "time": null,
  "phoneNumber": null,
  "appearanceIcon": null,
  "appearanceColor": null
}

Responses

201Activity created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/activities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"00000000-0000-4000-8000-000000000000\",
  \"activityType\": \"string\",
  \"date\": null,
  \"time\": null,
  \"phoneNumber\": null,
  \"appearanceIcon\": null,
  \"appearanceColor\": null
}"
PUT/customers/activities
Auth required

Update activity

DEPRECATED (sunset 2026-06-30): Updates an activity. Use PUT /api/customers/interactions instead.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "date": null,
  "time": null,
  "phoneNumber": null,
  "appearanceIcon": null,
  "appearanceColor": null
}

Responses

200Activity updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/customers/activities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"date\": null,
  \"time\": null,
  \"phoneNumber\": null,
  \"appearanceIcon\": null,
  \"appearanceColor\": null
}"
DELETE/customers/activities
Auth required

Delete activity

DEPRECATED (sunset 2026-06-30): Deletes an activity. Use DELETE /api/customers/interactions instead.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Activity deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/customers/activities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/customers/addresses
Auth required

List addresss

Returns a paginated collection of addresss scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
entityIdqueryNoany—
idqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated addresss
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "entity_id": "00000000-0000-4000-8000-000000000000",
      "name": null,
      "purpose": null,
      "company_name": null,
      "address_line1": null,
      "address_line2": null,
      "building_number": null,
      "flat_number": null,
      "city": null,
      "region": null,
      "postal_code": null,
      "country": null,
      "latitude": null,
      "longitude": null,
      "is_primary": null,
      "organization_id": null,
      "tenant_id": null,
      "updated_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/addresses?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/customers/addresses
Auth required

Create address

Creates a customer address record and associates it with the referenced entity.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "entityId": "00000000-0000-4000-8000-000000000000",
  "addressLine1": "string",
  "latitude": null,
  "longitude": null
}

Responses

201Address created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/addresses" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"entityId\": \"00000000-0000-4000-8000-000000000000\",
  \"addressLine1\": \"string\",
  \"latitude\": null,
  \"longitude\": null
}"
PUT/customers/addresses
Auth required

Update address

Updates fields on an existing customer address.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "latitude": null,
  "longitude": null
}

Responses

200Address updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/customers/addresses" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"latitude\": null,
  \"longitude\": null
}"
DELETE/customers/addresses
Auth required

Delete address

Deletes an address by id. The identifier may be included in the body or query.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Address deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/customers/addresses" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/customers/assignable-staff
Auth required

DEPRECATED: use GET /api/staff/team-members/assignable instead.

Deprecated. Returns 308 Permanent Redirect to /api/staff/team-members/assignable preserving the query string. Will be removed no earlier than the next major release.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—

Responses

200Assignable staff members (only reachable by following the redirect).
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "teamMemberId": "00000000-0000-4000-8000-000000000000",
      "userId": "00000000-0000-4000-8000-000000000000",
      "displayName": "string",
      "email": null,
      "teamName": null,
      "user": null,
      "team": null
    }
  ],
  "total": 1,
  "totalPages": 1
}
308Permanent redirect to /api/staff/team-members/assignable.
Content-Type: application/json
{
  "error": "string"
}
400Invalid request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/assignable-staff?page=1&pageSize=24" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/customers/comments
Auth required

List comments

Returns a paginated collection of comments scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
entityIdqueryNoany—
dealIdqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated comments
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "entity_id": null,
      "deal_id": null,
      "body": null,
      "author_user_id": null,
      "appearance_icon": null,
      "appearance_color": null,
      "organization_id": null,
      "tenant_id": null,
      "created_at": null,
      "updated_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/comments?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/customers/comments
Auth required

Create comment

Adds a comment to a customer timeline.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "entityId": "00000000-0000-4000-8000-000000000000",
  "body": "string",
  "appearanceIcon": null,
  "appearanceColor": null
}

Responses

201Comment created
Content-Type: application/json
{
  "id": null,
  "authorUserId": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/comments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"entityId\": \"00000000-0000-4000-8000-000000000000\",
  \"body\": \"string\",
  \"appearanceIcon\": null,
  \"appearanceColor\": null
}"
PUT/customers/comments
Auth required

Update comment

Updates an existing timeline comment.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "appearanceIcon": null,
  "appearanceColor": null
}

Responses

200Comment updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/customers/comments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"appearanceIcon\": null,
  \"appearanceColor\": null
}"
DELETE/customers/comments
Auth required

Delete comment

Deletes a comment identified by `id` supplied via body or query string.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Comment deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/customers/comments" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/customers/companies
Auth required

List companies

Returns a paginated collection of companies scoped to the authenticated organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
emailqueryNoany—
emailStartsWithqueryNoany—
emailContainsqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
statusqueryNoany—
lifecycleStagequeryNoany—
sourcequeryNoany—
hasEmailqueryNoany—
hasPhonequeryNoany—
hasNextInteractionqueryNoany—
createdFromqueryNoany—
createdToqueryNoany—
idqueryNoany—
tagIdsqueryNoany—
tagIdsEmptyqueryNoany—
excludeIdsqueryNoany—
excludeLinkedPersonIdqueryNoany—
excludeLinkedCompanyIdqueryNoany—
excludeLinkedDealIdqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated companies
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "description": null,
      "owner_user_id": null,
      "primary_email": null,
      "primary_phone": null,
      "status": null,
      "lifecycle_stage": null,
      "source": null,
      "next_interaction_at": null,
      "next_interaction_name": null,
      "next_interaction_ref_id": null,
      "next_interaction_icon": null,
      "next_interaction_color": null,
      "organization_id": null,
      "tenant_id": null,
      "created_at": null
    }
  ],
  "total": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/companies?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/customers/companies
Auth required

Create company

Creates a company record and associated profile data.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "displayName": "string",
  "description": null,
  "primaryEmail": null,
  "primaryPhone": null,
  "nextInteraction": null,
  "legalName": null,
  "brandName": null,
  "domain": null,
  "websiteUrl": null,
  "sizeBucket": null,
  "annualRevenue": null
}

Responses

201Company created
Content-Type: application/json
{
  "id": null,
  "companyId": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/customers/companies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"displayName\": \"string\",
  \"description\": null,
  \"primaryEmail\": null,
  \"primaryPhone\": null,
  \"nextInteraction\": null,
  \"legalName\": null,
  \"brandName\": null,
  \"domain\": null,
  \"websiteUrl\": null,
  \"sizeBucket\": null,
  \"annualRevenue\": null
}"
PUT/customers/companies
Auth required

Update company

Updates company profile fields, tags, or custom attributes.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "description": null,
  "primaryEmail": null,
  "primaryPhone": null,
  "nextInteraction": null,
  "legalName": null,
  "brandName": null,
  "domain": null,
  "websiteUrl": null,
  "sizeBucket": null,
  "annualRevenue": null
}

Responses

200Company updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/customers/companies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"description\": null,
  \"primaryEmail\": null,
  \"primaryPhone\": null,
  \"nextInteraction\": null,
  \"legalName\": null,
  \"brandName\": null,
  \"domain\": null,
  \"websiteUrl\": null,
  \"sizeBucket\": null,
  \"annualRevenue\": null
}"
DELETE/customers/companies
Auth required

Delete company

Deletes a company by id. The identifier can be provided via body or query.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Company deleted
Content-Type: application/json
{
  "ok": true
}
422Company has dependent records (people, deals, or direct staff); unlink or reassign before delete.
Content-Type: application/json
{
  "error": "string",
  "code": "COMPANY_HAS_DEPENDENTS"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/customers/companies" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/customers/companies/{id}
Auth required

Fetch company with related data

Returns a company customer record with optional related resources such as addresses, comments, activities, interactions, deals, todos, and linked people.

Parameters

NameInRequiredSchemaDescription
idpathYesany—
includequeryNoanyComma-separated list of relations to include (addresses, comments, activities, interactions, deals, todos, people).

Responses

200Company detail payload
Content-Type: application/json
{
  "interactionMode": "canonical",
  "company": {
    "id": "00000000-0000-4000-8000-000000000000",
    "displayName": null,
    "description": null,
    "ownerUserId": null,
    "primaryEmail": null,
    "primaryPhone": null,
    "status": null,
    "lifecycleStage": null,
    "source": null,
    "nextInteractionAt": null,
    "nextInteractionName": null,
    "nextInteractionRefId": null,
    "nextInteractionIcon": null,
    "nextInteractionColor": null,
    "organizationId": null,
    "tenantId": null,
    "temperature": null,
    "renewalQuarter": null,
    "createdAt": "string",
    "updatedAt": "string"
  },
  "profile": null,
  "customFields": {},
  "tags": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "label": "string",
      "color": null
    }
  ],
  "addresses": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": null,
      "purpose": null,
      "addressLine1": null,
      "addressLine2": null,
      "buildingNumber": null,
      "flatNumber": null,
      "city": null,
      "region": null,
      "postalCode": null,
      "country": null,
      "latitude": null,
      "longitude": null,
      "isPrimary": null,
      "createdAt": "string"
    }
  ],
  "comments": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "body": null,
      "authorUserId": null,
      "authorName": null,
      "authorEmail": null,
      "dealId": null,
      "createdAt": "string",
      "appearanceIcon": null,
      "appearanceColor": null
    }
  ],
  "activities": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "activityType": "string",
      "subject": null,
      "body": null,
      "occurredAt": null,
      "dealId": null,
      "authorUserId": null,
      "authorName": null,
      "authorEmail": null,
      "createdAt": "string",
      "appearanceIcon": null,
      "appearanceColor": null
    }
  ],
  "interactions": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "entityId": null,
      "interactionType": "string",
      "title": null,
      "body": null,
      "status": "string",
      "scheduledAt": null,
      "occurredAt": null,
      "priority": null,
      "authorUserId": null,
      "ownerUserId": null,
      "dealId": null,
      "organizationId": null,
      "tenantId": null,
      "authorName": null,
      "authorEmail": null,
      "dealTitle": null,
      "customValues": null,
      "appearanceIcon": null,
      "appearanceColor": null,
      "source": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "deals": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "title": null,
      "status": null,
      "pipelineStage": null,
      "valueAmount": null,
      "valueCurrency": null,
      "probability": null,
      "expectedCloseAt": null,
      "ownerUserId": null,
      "source": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "todos": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "todoId": "00000000-0000-4000-8000-000000000000",
      "todoSource": "string",
      "createdAt": "string",
      "createdByUserId": null,
      "title": null,
      "isDone": null,
      "priority": null,
      "severity": null,
      "description": null,
      "dueAt": null,
      "todoOrganizationId": null,
      "customValues": null
    }
  ],
  "people": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "displayName": null,
      "primaryEmail": null,
      "primaryPhone": null,
      "status": null,
      "lifecycleStage": null,
      "jobTitle": null,
      "department": null,
      "createdAt": "string",
      "organizationId": null,
      "source": null,
      "temperature": null,
      "linkedAt": null
    }
  ],
  "viewer": {
    "userId": null,
    "name": null,
    "email": null
  }
}
400Invalid identifier
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden — caller lacks the required feature
Content-Type: application/json
{
  "error": "string"
}
404Company not found, or its organization is not in the caller’s scope
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/companies/:id" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/customers/companies/{id}/people
Auth required

List linked people for a company

Parameters

NameInRequiredSchemaDescription
idpathYesany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
sortqueryNoany—

Responses

200Paginated linked people
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "displayName": "string",
      "primaryEmail": null,
      "primaryPhone": null,
      "status": null,
      "lifecycleStage": null,
      "jobTitle": null,
      "department": null,
      "createdAt": "string",
      "organizationId": null,
      "temperature": null,
      "source": null,
      "linkedAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/companies/:id/people?page=1&pageSize=20&sort=name-asc" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/customers/companies/{id}/roles
Auth required

List roles for a company

Parameters

NameInRequiredSchemaDescription
idpathYesany—

Responses

200Role assignments
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "entityType": "company",
      "entityId": "00000000-0000-4000-8000-000000000000",
      "userId": "00000000-0000-4000-8000-000000000000",
      "userName": null,
      "userEmail": null,
      "userPhone": null,
      "roleType": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}
400Invalid request
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/customers/companies/00000000-0000-4000-8000-000000000000/roles" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Dashboards

Showing 10 of 10 endpoints
GET/dashboards/layout
Auth required

Load the current dashboard layout

Returns the saved widget layout together with the widgets the current user is allowed to place.

Responses

200Current dashboard layout and available widgets.
Content-Type: application/json
{
  "layout": {
    "items": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "widgetId": "string",
        "order": 1
      }
    ]
  },
  "allowedWidgetIds": [
    "string"
  ],
  "canConfigure": true,
  "context": {
    "userId": "00000000-0000-4000-8000-000000000000",
    "tenantId": null,
    "organizationId": null,
    "userName": null,
    "userEmail": null,
    "userLabel": "string"
  },
  "widgets": [
    {
      "id": "string",
      "title": "string",
      "description": null,
      "defaultSize": "sm",
      "defaultEnabled": true,
      "defaultSettings": null,
      "features": [
        "string"
      ],
      "moduleId": "string",
      "icon": null,
      "loaderKey": "string",
      "supportsRefresh": true
    }
  ]
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dashboards/layout" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/dashboards/layout
Auth required

Persist dashboard layout changes

Saves the provided widget ordering, sizes, and settings for the current user.

Request body (application/json)

{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "widgetId": "string",
      "order": 1
    }
  ]
}

Responses

200Layout updated successfully.
Content-Type: application/json
{
  "ok": true
}
400Invalid layout payload
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing dashboards.configure feature
Content-Type: application/json
{
  "error": "string"
}
503Widget registry unavailable — the layout was not saved
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/dashboards/layout" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"items\": [
    {
      \"id\": \"00000000-0000-4000-8000-000000000000\",
      \"widgetId\": \"string\",
      \"order\": 1
    }
  ]
}"
PATCH/dashboards/layout/{itemId}
Auth required

Update a dashboard layout item

Adjusts the size or settings for a single widget within the dashboard layout.

Parameters

NameInRequiredSchemaDescription
itemIdpathYesany—

Request body (application/json)

{}

Responses

200Layout item updated.
Content-Type: application/json
{
  "ok": true
}
400Invalid payload or missing item id
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing dashboards.configure feature
Content-Type: application/json
{
  "error": "string"
}
404Item not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/dashboards/layout/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
GET/dashboards/roles/widgets
Auth required

Fetch widget assignments for a role

Returns the widgets explicitly assigned to the given role together with the evaluation scope.

Parameters

NameInRequiredSchemaDescription
roleIdqueryYesany—
tenantIdqueryNoany—
organizationIdqueryNoany—

Responses

200Current widget configuration for the role.
Content-Type: application/json
{
  "widgetIds": [
    "string"
  ],
  "hasCustom": true,
  "scope": {
    "tenantId": null,
    "organizationId": null
  }
}
400Missing role identifier
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Insufficient permissions to manage role widgets
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dashboards/roles/widgets?roleId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/dashboards/roles/widgets
Auth required

Update widgets assigned to a role

Persists the widget list for a role within the provided tenant and organization scope.

Request body (application/json)

{
  "roleId": "00000000-0000-4000-8000-000000000000",
  "widgetIds": [
    "string"
  ]
}

Responses

200Widgets updated successfully.
Content-Type: application/json
{
  "ok": true,
  "widgetIds": [
    "string"
  ]
}
400Invalid payload or unknown widgets
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Insufficient permissions to manage role widgets
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/dashboards/roles/widgets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"roleId\": \"00000000-0000-4000-8000-000000000000\",
  \"widgetIds\": [
    \"string\"
  ]
}"
GET/dashboards/users/widgets
Auth required

Read widget overrides for a user

Returns the widgets inherited and explicitly configured for the requested user within the current scope.

Parameters

NameInRequiredSchemaDescription
userIdqueryYesany—
tenantIdqueryNoany—
organizationIdqueryNoany—

Responses

200Widget settings for the user.
Content-Type: application/json
{
  "mode": "inherit",
  "widgetIds": [
    "string"
  ],
  "hasCustom": true,
  "effectiveWidgetIds": [
    "string"
  ],
  "scope": {
    "tenantId": null,
    "organizationId": null
  }
}
400Missing user identifier
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Insufficient permissions to manage user widgets
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dashboards/users/widgets?userId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/dashboards/users/widgets
Auth required

Update user-specific dashboard widgets

Sets the widget override mode and allowed widgets for a user. Passing `mode: inherit` clears overrides.

Request body (application/json)

{
  "userId": "00000000-0000-4000-8000-000000000000",
  "mode": "inherit",
  "widgetIds": [
    "string"
  ]
}

Responses

200Overrides saved.
Content-Type: application/json
{
  "ok": true,
  "mode": "inherit",
  "widgetIds": [
    "string"
  ]
}
400Invalid payload or unknown widgets
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Insufficient permissions to manage user widgets
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/dashboards/users/widgets" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"userId\": \"00000000-0000-4000-8000-000000000000\",
  \"mode\": \"inherit\",
  \"widgetIds\": [
    \"string\"
  ]
}"
GET/dashboards/widgets/catalog
Auth required

List available dashboard widgets

Returns the catalog of widgets that modules expose, including defaults and feature requirements.

Responses

200Widgets available for assignment.
Content-Type: application/json
{
  "items": [
    {
      "id": "string",
      "title": "string",
      "description": null,
      "defaultSize": "sm",
      "defaultEnabled": true,
      "defaultSettings": null,
      "features": [
        "string"
      ],
      "moduleId": "string",
      "icon": null,
      "loaderKey": "string",
      "supportsRefresh": true
    }
  ]
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Insufficient permissions to view widget catalog
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dashboards/widgets/catalog" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/dashboards/widgets/data
Auth required

Fetch aggregated data for dashboard widgets

Executes an aggregation query against the specified entity type and returns the result. Supports date range filtering, grouping, and period-over-period comparison.

Request body (application/json)

{
  "entityType": "string",
  "metric": {
    "field": "string",
    "aggregate": "count"
  }
}

Responses

200Aggregated data for the widget.
Content-Type: application/json
{
  "value": null,
  "data": [
    {
      "value": null
    }
  ],
  "metadata": {
    "fetchedAt": "string",
    "recordCount": 1,
    "currency": null
  }
}
400Invalid request payload
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing analytics.view feature
Content-Type: application/json
{
  "error": "string"
}
422Too many rows to group an encrypted field in application code
Content-Type: application/json
{
  "error": "string"
}
500Internal server error
Content-Type: application/json
{
  "error": "string"
}
503Encryption is configured but the group source cannot currently be resolved
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dashboards/widgets/data" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityType\": \"string\",
  \"metric\": {
    \"field\": \"string\",
    \"aggregate\": \"count\"
  }
}"
POST/dashboards/widgets/data/batch
Auth required

Fetch aggregated data for multiple dashboard widgets in one request

Resolves a batch of widget data requests with a single authentication, RBAC, organization-scope, and database-context setup. Each request is keyed by an opaque widget id and resolved independently, so a failure in one widget does not fail the batch.

Request body (application/json)

{
  "requests": [
    {
      "id": "string",
      "request": {
        "entityType": "string",
        "metric": {
          "field": "string",
          "aggregate": "count"
        }
      }
    }
  ]
}

Responses

200Per-widget aggregation results keyed by request id.
Content-Type: application/json
{
  "results": [
    {
      "id": "string",
      "ok": true,
      "data": {
        "value": null,
        "data": [
          {
            "value": null
          }
        ],
        "metadata": {
          "fetchedAt": "string",
          "recordCount": 1,
          "currency": null
        }
      }
    }
  ]
}
400Invalid request payload
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
500Internal server error
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dashboards/widgets/data/batch" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"requests\": [
    {
      \"id\": \"string\",
      \"request\": {
        \"entityType\": \"string\",
        \"metric\": {
          \"field\": \"string\",
          \"aggregate\": \"count\"
        }
      }
    }
  ]
}"

Dictionaries

Showing 11 of 11 endpoints
GET/dictionaries
Auth required

List dictionaries

Returns dictionaries accessible to the current organization, optionally including inactive records.

Parameters

NameInRequiredSchemaDescription
includeInactivequeryNoany—

Responses

200Dictionary collection.
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "key": "string",
      "name": "string",
      "description": null,
      "isSystem": true,
      "isActive": true,
      "managerVisibility": null,
      "organizationId": null,
      "createdAt": "string",
      "updatedAt": null
    }
  ]
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
500Failed to load dictionaries
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dictionaries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/dictionaries
Auth required

Create dictionary

Registers a dictionary scoped to the current organization.

Request body (application/json)

{
  "key": "string",
  "name": "string"
}

Responses

201Dictionary created.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "key": "string",
  "name": "string",
  "description": null,
  "isSystem": true,
  "isActive": true,
  "managerVisibility": null,
  "organizationId": null,
  "createdAt": "string",
  "updatedAt": null
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
409Dictionary key already exists
Content-Type: application/json
{
  "error": "string"
}
500Failed to create dictionary
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dictionaries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"key\": \"string\",
  \"name\": \"string\"
}"
GET/dictionaries/{dictionaryId}
Auth required

Get dictionary

Returns details for the specified dictionary, including inheritance flags.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Responses

200Dictionary details.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "key": "string",
  "name": "string",
  "description": null,
  "isSystem": true,
  "isActive": true,
  "managerVisibility": null,
  "organizationId": null,
  "createdAt": "string",
  "updatedAt": null
}
400Invalid parameters
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to load dictionary
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PATCH/dictionaries/{dictionaryId}
Auth required

Update dictionary

Updates mutable attributes of the dictionary. Currency dictionaries are protected from modification.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Request body (application/json)

{}

Responses

200Dictionary updated.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "key": "string",
  "name": "string",
  "description": null,
  "isSystem": true,
  "isActive": true,
  "managerVisibility": null,
  "organizationId": null,
  "createdAt": "string",
  "updatedAt": null
}
400Validation failed or protected dictionary
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
409Dictionary key already exists
Content-Type: application/json
{
  "error": "string"
}
500Failed to update dictionary
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
DELETE/dictionaries/{dictionaryId}
Auth required

Delete dictionary

Soft deletes the dictionary unless it is the protected currency dictionary.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Responses

200Dictionary archived.
Content-Type: application/json
{
  "ok": true
}
400Protected dictionary cannot be deleted
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to delete dictionary
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/dictionaries/{dictionaryId}/entries
Auth required

List dictionary entries

Returns entries for the specified dictionary ordered by its configured entry sort mode. The number of entries returned per request is capped at 500; use `limit` and `offset` with the `total`/`hasMore` response fields to page through larger dictionaries.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—
limitqueryNoanyMaximum entries to return. Defaults to and is capped at 500.
offsetqueryNoanyNumber of entries to skip. Defaults to 0.

Responses

200Dictionary entries.
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "value": "string",
      "label": "string",
      "color": null,
      "icon": null,
      "position": 1,
      "isDefault": true,
      "createdAt": "string",
      "updatedAt": null
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1,
  "hasMore": true,
  "sortMode": "label_asc"
}
400Invalid parameters
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to load dictionary entries
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/dictionaries/{dictionaryId}/entries
Auth required

Create dictionary entry

Creates a new entry in the specified dictionary.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Request body (application/json)

{
  "value": "string",
  "color": null,
  "icon": null
}

Responses

201Dictionary entry created.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "value": "string",
  "label": "string",
  "color": null,
  "icon": null,
  "position": 1,
  "isDefault": true,
  "createdAt": "string",
  "updatedAt": null
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to create dictionary entry
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"value\": \"string\",
  \"color\": null,
  \"icon\": null
}"
PATCH/dictionaries/{dictionaryId}/entries/{entryId}
Auth required

Update dictionary entry

Updates the specified dictionary entry using the command bus pipeline.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—
entryIdpathYesany—

Request body (application/json)

{
  "color": null,
  "icon": null
}

Responses

200Dictionary entry updated.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "value": "string",
  "label": "string",
  "color": null,
  "icon": null,
  "position": 1,
  "isDefault": true,
  "createdAt": "string",
  "updatedAt": null
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary or entry not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to update entry
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PATCH "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"color\": null,
  \"icon\": null
}"
DELETE/dictionaries/{dictionaryId}/entries/{entryId}
Auth required

Delete dictionary entry

Deletes the specified dictionary entry via the command bus.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—
entryIdpathYesany—

Responses

200Entry deleted.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary or entry not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to delete entry
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries/00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/dictionaries/{dictionaryId}/entries/reorder
Auth required

Reorder dictionary entries

Updates the position of dictionary entries for drag-and-drop reordering.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Request body (application/json)

{
  "entries": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "position": 1
    }
  ]
}

Responses

200Entries reordered.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to reorder entries
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries/reorder" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entries\": [
    {
      \"id\": \"00000000-0000-4000-8000-000000000000\",
      \"position\": 1
    }
  ]
}"
POST/dictionaries/{dictionaryId}/entries/set-default
Auth required

Set default dictionary entry

Marks the specified entry as the default for this dictionary, clearing any previous default.

Parameters

NameInRequiredSchemaDescription
dictionaryIdpathYesany—

Request body (application/json)

{
  "entryId": "00000000-0000-4000-8000-000000000000"
}

Responses

200Default entry set.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
404Dictionary or entry not found
Content-Type: application/json
{
  "error": "string"
}
500Failed to set default entry
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/dictionaries/00000000-0000-4000-8000-000000000000/entries/set-default" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entryId\": \"00000000-0000-4000-8000-000000000000\"
}"

Directory

Showing 11 of 11 endpoints
GET/directory/organization-branding
Auth required

Read sidebar branding for the selected organization

Returns the logo URL used by the backend sidebar for the currently selected organization.

Responses

200Organization branding
Content-Type: application/json
{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "organizationName": "string",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "logoUrl": null,
  "logoPreserveAspectRatio": true,
  "updatedAt": null
}
400A concrete organization scope is required
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
404Organization not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/organization-branding" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/directory/organization-branding
Auth required

Update sidebar branding for the selected organization

Stores an external image URL or an internal attachment image URL as the selected organization logo.

Request body (application/json)

{
  "logoUrl": null
}

Responses

200Updated organization branding
Content-Type: application/json
{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "organizationName": "string",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "logoUrl": null,
  "logoPreserveAspectRatio": true,
  "updatedAt": null
}
400Save failed
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
409Organization branding changed since it was loaded
Content-Type: application/json
{
  "error": "string"
}
422Invalid logo URL
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/directory/organization-branding" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"logoUrl\": null
}"
GET/directory/organization-switcher
Auth required

Load organization switcher menu

Returns the hierarchical menu of organizations the current user may switch to within the active tenant.

Responses

200Organization switcher payload.
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "depth": 1,
      "selectable": true,
      "children": []
    }
  ],
  "selectedId": null,
  "canManage": true,
  "canViewAllOrganizations": true,
  "tenantId": null,
  "tenants": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "isActive": true
    }
  ],
  "isSuperAdmin": true
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/organization-switcher" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/directory/organizations
Auth required

List organizations

Returns organizations using options, tree, or paginated manage view depending on the `view` parameter.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
viewqueryNoany—
idsqueryNoany—
tenantIdqueryNoany—
includeInactivequeryNoany—
statusqueryNoany—

Responses

200Organization data for the requested view.
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "parentId": null,
      "parentName": null,
      "tenantId": null,
      "tenantName": null,
      "rootId": null,
      "treePath": null
    }
  ]
}
400Invalid query or tenant scope
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/organizations?page=1&pageSize=50&view=options" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/directory/organizations
Auth required

Create organization

Creates a new organization within a tenant and optionally assigns hierarchy relationships.

Request body (application/json)

{
  "name": "string",
  "slug": null,
  "logoUrl": null,
  "parentId": null
}

Responses

201Organization created.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.organizations.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/directory/organizations" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"name\": \"string\",
  \"slug\": null,
  \"logoUrl\": null,
  \"parentId\": null
}"
PUT/directory/organizations
Auth required

Update organization

Updates organization details and hierarchy assignments. Fields that are omitted keep their current value; send `parentId: null` or `childIds: []` to clear the parent or the children.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "slug": null,
  "logoUrl": null,
  "parentId": null
}

Responses

200Organization updated.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.organizations.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/directory/organizations" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"slug\": null,
  \"logoUrl\": null,
  \"parentId\": null
}"
DELETE/directory/organizations
Auth required

Delete organization

Soft deletes an organization identified by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Organization deleted.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.organizations.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/directory/organizations" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/directory/tenants
Auth required

List tenants

Returns tenants visible to the current user with optional search and pagination.

Parameters

NameInRequiredSchemaDescription
idqueryNoany—
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
isActivequeryNoany—

Responses

200Paged list of tenants.
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "isActive": true,
      "createdAt": null,
      "updatedAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Requires super-admin
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/directory/tenants?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/directory/tenants
Auth required

Create tenant

Creates a new tenant and returns its identifier.

Request body (application/json)

{
  "name": "string"
}

Responses

201Tenant created.
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.tenants.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/directory/tenants" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"name\": \"string\"
}"
PUT/directory/tenants
Auth required

Update tenant

Updates tenant properties such as name or activation state.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Tenant updated.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.tenants.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/directory/tenants" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/directory/tenants
Auth required

Delete tenant

Soft deletes the tenant identified by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Tenant removed.
Content-Type: application/json
{
  "ok": true
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Missing directory.tenants.manage feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/directory/tenants" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"

Entities

Showing 19 of 19 endpoints
GET/entities/definitions
Auth required

List active custom field definitions

Returns active custom field definitions for the supplied entity ids, respecting tenant scope and tombstones.

Parameters

NameInRequiredSchemaDescription
entityIdqueryNoany—
entityIdsqueryNoany—
fieldsetqueryNoany—

Responses

200Definition list
Content-Type: application/json
{
  "items": [
    {
      "key": "string",
      "kind": "string",
      "label": "string",
      "entityId": "string"
    }
  ]
}
400Missing entity id
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/definitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/entities/definitions
Auth required

Upsert custom field definition

Creates or updates a custom field definition for the current tenant/org scope.

Request body (application/json)

{
  "entityId": "string",
  "key": "string",
  "kind": "text"
}

Responses

200Definition saved
Content-Type: application/json
{
  "ok": true,
  "item": {
    "id": "00000000-0000-4000-8000-000000000000",
    "key": "string",
    "kind": "string",
    "configJson": {}
  }
}
400Validation failed
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/definitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"key\": \"string\",
  \"kind\": \"text\"
}"
DELETE/entities/definitions
Auth required

Soft delete custom field definition

Marks the specified definition inactive and tombstones it for the current scope.

Request body (application/json)

{
  "entityId": "string",
  "key": "string"
}

Responses

200Definition deleted
Content-Type: application/json
{
  "ok": true,
  "version": null
}
400Missing entity id or key
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
404Definition not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/entities/definitions" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"key\": \"string\"
}"
POST/entities/definitions.batch
Auth required

Save multiple custom field definitions

Creates or updates multiple definitions for a single entity in one transaction.

Request body (application/json)

{
  "entityId": "string",
  "definitions": [
    {
      "key": "string",
      "kind": "text"
    }
  ]
}

Responses

200Definitions saved
Content-Type: application/json
{
  "ok": true,
  "version": null
}
400Validation error
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
500Unexpected failure
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/definitions.batch" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"definitions\": [
    {
      \"key\": \"string\",
      \"kind\": \"text\"
    }
  ]
}"
GET/entities/definitions.manage
Auth required

Get management snapshot

Returns scoped custom field definitions (including inactive tombstones) for administration interfaces.

Parameters

NameInRequiredSchemaDescription
entityIdqueryYesany—

Responses

200Scoped definitions and deleted keys
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "key": "string",
      "kind": "string",
      "configJson": null,
      "organizationId": null,
      "tenantId": null
    }
  ],
  "deletedKeys": [
    "string"
  ],
  "version": null
}
400Missing entity id
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication or feature
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/definitions.manage?entityId=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/entities/definitions.restore
Auth required

Restore definition

Reactivates a previously soft-deleted definition within the current tenant/org scope.

Request body (application/json)

{
  "entityId": "string",
  "key": "string"
}

Responses

200Definition restored
Content-Type: application/json
{
  "ok": true
}
400Missing entity id or key
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
404Definition not found
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/definitions.restore" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"key\": \"string\"
}"
GET/entities/encryption
Auth required

Fetch encryption map

Returns the encrypted field map for the current tenant/organization scope.

Parameters

NameInRequiredSchemaDescription
entityIdqueryYesany—

Responses

200Map
Content-Type: application/json
{
  "entityId": "string",
  "fields": [
    {
      "field": "string",
      "hashField": null
    }
  ],
  "updatedAt": null
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/encryption?entityId=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/entities/encryption
Auth required

Upsert encryption map

Creates or updates the encryption map for the current tenant/organization scope. Enforces optimistic locking when the caller sends the expected version header.

Request body (application/json)

{
  "entityId": "string",
  "tenantId": null,
  "organizationId": null,
  "fields": [
    {
      "field": "string",
      "hashField": null
    }
  ]
}

Responses

200Saved
Content-Type: application/json
{
  "ok": true,
  "updatedAt": null
}
409Optimistic-lock conflict (stale write)
Content-Type: application/json
{
  "error": "string",
  "code": "string",
  "currentUpdatedAt": "string",
  "expectedUpdatedAt": "string"
}
422Selected organization is unavailable
Content-Type: application/json
{
  "error": "string",
  "code": "organization_selection_invalid"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/encryption" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"tenantId\": null,
  \"organizationId\": null,
  \"fields\": [
    {
      \"field\": \"string\",
      \"hashField\": null
    }
  ]
}"
GET/entities/entities
Auth required

List available entities

Returns generated and custom entities scoped to the caller with field counts per entity.

Responses

200List of entities
Content-Type: application/json
{
  "items": [
    {
      "entityId": "string",
      "source": "code",
      "label": "string",
      "count": 1
    }
  ]
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/entities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/entities/entities
Auth required

Upsert custom entity

Creates or updates a tenant/org scoped custom entity definition.

Request body (application/json)

{
  "entityId": "string",
  "label": "string",
  "description": null,
  "showInSidebar": false,
  "accessRestricted": false
}

Responses

200Entity saved
Content-Type: application/json
{
  "ok": true,
  "item": {
    "id": "00000000-0000-4000-8000-000000000000",
    "entityId": "string",
    "label": "string"
  }
}
400Validation error
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/entities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"label\": \"string\",
  \"description\": null,
  \"showInSidebar\": false,
  \"accessRestricted\": false
}"
DELETE/entities/entities
Auth required

Soft delete custom entity

Marks the specified custom entity inactive within the current scope.

Request body (application/json)

{
  "entityId": "string"
}

Responses

200Entity deleted
Content-Type: application/json
{
  "ok": true
}
400Missing entity id
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
404Entity not found in scope
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/entities/entities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\"
}"
GET/entities/entity-settings
Auth required

Get custom entity settings

Returns the tenant-scoped default-restricted policy for new custom entities.

Responses

200Current settings
Content-Type: application/json
{
  "newEntitiesRestrictedByDefault": true,
  "updatedAt": null
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/entity-settings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
PUT/entities/entity-settings
Auth required

Update custom entity settings

Sets the tenant-scoped default-restricted policy for new custom entities.

Request body (application/json)

{
  "newEntitiesRestrictedByDefault": true
}

Responses

200Updated settings
Content-Type: application/json
{
  "ok": true,
  "newEntitiesRestrictedByDefault": true,
  "updatedAt": null
}
400Invalid payload
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
409Optimistic lock conflict
Content-Type: application/json
{
  "code": "string",
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/entities/entity-settings" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"newEntitiesRestrictedByDefault\": true
}"
GET/entities/records
Auth required

List records

Returns paginated records for the supplied entity. Supports custom field filters, exports, and soft-delete toggles.

Parameters

NameInRequiredSchemaDescription
entityIdqueryYesany—
pagequeryNoany—
pageSizequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
searchqueryNoany—
searchFieldsqueryNoany—
withDeletedqueryNoany—
formatqueryNoany—
exportScopequeryNoany—
export_scopequeryNoany—
allqueryNoany—
fullqueryNoany—

Responses

200Paginated records
Content-Type: application/json
{
  "items": [
    {}
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}
400Missing entity id
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
500Unexpected failure
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/records?entityId=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/entities/records
Auth required

Create record

Creates a record for the given entity. When `recordId` is omitted or not a UUID the data engine will generate one automatically.

Request body (application/json)

{
  "entityId": "string",
  "values": {}
}

Responses

200Record created
Content-Type: application/json
{
  "ok": true
}
400Validation failure
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
500Unexpected failure
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/entities/records" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"values\": {}
}"
PUT/entities/records
Auth required

Update record

Updates an existing record. If the provided recordId is not a UUID the record will be created instead to support optimistic flows.

Request body (application/json)

{
  "entityId": "string",
  "recordId": "string",
  "values": {}
}

Responses

200Record updated
Content-Type: application/json
{
  "ok": true
}
400Validation failure
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
500Unexpected failure
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/entities/records" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"recordId\": \"string\",
  \"values\": {}
}"
DELETE/entities/records
Auth required

Delete record

Soft deletes the specified record within the current tenant/org scope.

Request body (application/json)

{
  "entityId": "string",
  "recordId": "string"
}

Responses

200Record deleted
Content-Type: application/json
{
  "ok": true
}
400Missing entity id or record id
Content-Type: application/json
{
  "error": "string"
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}
404Record not found
Content-Type: application/json
{
  "error": "string"
}
500Unexpected failure
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/entities/records" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityId\": \"string\",
  \"recordId\": \"string\"
}"
GET/entities/relations/options
Auth required

List relation options

Returns up to 200 option entries for populating relation dropdowns, automatically resolving label fields when omitted. An entityId that matches neither an active custom entity nor a registered ORM entity yields an empty option list.

Parameters

NameInRequiredSchemaDescription
entityIdqueryYesany—
labelFieldqueryNoany—
qqueryNoany—
idsqueryNoany—
routeContextFieldsqueryNoany—

Responses

200Option list
Content-Type: application/json
{
  "items": [
    {
      "value": "string",
      "label": "string"
    }
  ]
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/relations/options?entityId=string" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
GET/entities/sidebar-entities
Auth required

Get sidebar entities

Returns custom entities flagged with `showInSidebar` for the current tenant/org scope.

Responses

200Sidebar entities for navigation
Content-Type: application/json
{
  "items": [
    {
      "entityId": "string",
      "label": "string",
      "href": "string"
    }
  ]
}
401Missing authentication
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/entities/sidebar-entities" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Query Index

Showing 3 of 3 endpoints
POST/query_index/purge
Auth required

Purge query index records

Queues a purge job to remove indexed records for an entity type within the active scope.

Request body (application/json)

{
  "entityType": "string"
}

Responses

200Purge job accepted.
Content-Type: application/json
{
  "ok": true
}
400Missing entity type
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/query_index/purge" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityType\": \"string\"
}"
POST/query_index/reindex
Auth required

Trigger query index rebuild

Queues a reindex job for the specified entity type within the current tenant scope.

Request body (application/json)

{
  "entityType": "string"
}

Responses

200Reindex job accepted.
Content-Type: application/json
{
  "ok": true
}
400Missing entity type
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/query_index/reindex" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"entityType\": \"string\"
}"
GET/query_index/status
Auth required

Inspect query index coverage

Returns entity counts comparing base tables with the query index along with the latest job status.

Responses

200Current query index status.
Content-Type: application/json
{
  "items": [
    {
      "entityId": "string",
      "label": "string",
      "baseCount": null,
      "indexCount": null,
      "vectorCount": null,
      "fulltextCount": null,
      "ok": true,
      "job": {
        "status": "idle",
        "startedAt": null,
        "finishedAt": null,
        "heartbeatAt": null,
        "processedCount": null,
        "totalCount": null,
        "scope": null
      },
      "refreshedAt": null
    }
  ],
  "errors": [
    {
      "id": "string",
      "source": "string",
      "handler": "string",
      "entityType": null,
      "recordId": null,
      "tenantId": null,
      "organizationId": null,
      "message": "string",
      "stack": null,
      "payload": null,
      "occurredAt": "string"
    }
  ],
  "logs": [
    {
      "id": "string",
      "source": "string",
      "handler": "string",
      "level": "info",
      "entityType": null,
      "recordId": null,
      "tenantId": null,
      "organizationId": null,
      "message": "string",
      "details": null,
      "occurredAt": "string"
    }
  ]
}
400Tenant or organization context required
Content-Type: application/json
{
  "error": "string"
}
401Authentication required
Content-Type: application/json
{
  "error": "string"
}
403Organization access denied
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/query_index/status" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"

Sales

Showing 20 of 110 endpoints
GET/sales/adjustment-kinds
Auth required

List sales adjustment kinds

Returns a paginated collection of sales adjustment kinds that belong to the current organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated sales adjustment kinds
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "value": "string",
      "label": null,
      "color": null,
      "icon": null,
      "organizationId": null,
      "tenantId": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/adjustment-kinds?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/sales/adjustment-kinds
Auth required

Create sales adjustment kind

Creates an adjustment kind.

Request body (application/json)

{}

Responses

201Sales adjustment kind created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/sales/adjustment-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
PUT/sales/adjustment-kinds
Auth required

Update sales adjustment kind

Updates an adjustment kind.

Request body (application/json)

{}

Responses

200Sales adjustment kind updated
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/sales/adjustment-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
DELETE/sales/adjustment-kinds
Auth required

Delete sales adjustment kind

Deletes an adjustment kind.

Request body (application/json)

{}

Responses

200Sales adjustment kind deleted
Content-Type: application/json
{
  "id": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/sales/adjustment-kinds" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{}"
GET/sales/channels
Auth required

List sales channels

Manage sales channels to segment orders and pricing across marketplaces or stores.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
idqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).
isActivequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
withDeletedqueryNoany—

Responses

200Paginated sales channels
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "code": null,
      "description": null,
      "statusEntryId": null,
      "isActive": true,
      "organizationId": null,
      "tenantId": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/channels?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/sales/channels
Auth required

Create sales channel

Creates a new sales channel.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "code": "string"
}

Responses

201Sales channel created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/sales/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"name\": \"string\",
  \"code\": \"string\"
}"
PUT/sales/channels
Auth required

Update sales channel

Updates an existing sales channel by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000",
  "code": "string"
}

Responses

200Sales channel updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/sales/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\",
  \"code\": \"string\"
}"
DELETE/sales/channels
Auth required

Delete sales channel

Deletes a sales channel identified by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Sales channel deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/sales/channels" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/sales/credit-memos
Auth required

List creditmemos

Returns a paginated collection of creditmemos that belong to the current organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
idqueryNoany—
orderIdqueryNoany—
invoiceIdqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated creditmemos
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "creditMemoNumber": "string",
      "status": null,
      "reason": null,
      "issueDate": null,
      "currencyCode": "string"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/credit-memos?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/sales/credit-memos
Auth required

Create creditmemo

Create a new credit memo

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "currencyCode": "string"
}

Responses

201CreditMemo created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/sales/credit-memos" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"currencyCode\": \"string\"
}"
PUT/sales/credit-memos
Auth required

Update creditmemo

Update a credit memo

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200CreditMemo updated
Content-Type: application/json
{
  "creditMemoId": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/sales/credit-memos" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/sales/credit-memos
Auth required

Delete creditmemo

Delete a credit memo

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200CreditMemo deleted
Content-Type: application/json
{
  "creditMemoId": "00000000-0000-4000-8000-000000000000"
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/sales/credit-memos" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/sales/dashboard/widgets/new-orders

Fetch recently created sales orders

Fetches recently created sales orders for the dashboard widget with a configurable date period.

Parameters

NameInRequiredSchemaDescription
limitqueryNoany—
datePeriodqueryNoany—
customFromqueryNoany—
customToqueryNoany—
tenantIdqueryNoany—
organizationIdqueryNoany—

Responses

200List of recent orders
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "orderNumber": "string",
      "status": null,
      "fulfillmentStatus": null,
      "paymentStatus": null,
      "customerName": null,
      "customerEntityId": null,
      "netAmount": "string",
      "grossAmount": "string",
      "currency": null,
      "createdAt": "string"
    }
  ],
  "total": 1,
  "dateRange": {
    "from": "string",
    "to": "string"
  }
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden
Content-Type: application/json
{
  "error": "string"
}
500Widget failed to load
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/dashboard/widgets/new-orders?limit=5&datePeriod=last24h" \
  -H "Accept: application/json"
GET/sales/dashboard/widgets/new-quotes

Fetch recently created sales quotes

Fetches recently created sales quotes for the dashboard widget with a configurable date period.

Parameters

NameInRequiredSchemaDescription
limitqueryNoany—
datePeriodqueryNoany—
customFromqueryNoany—
customToqueryNoany—
tenantIdqueryNoany—
organizationIdqueryNoany—

Responses

200List of recent quotes
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "quoteNumber": "string",
      "status": null,
      "customerName": null,
      "customerEntityId": null,
      "validFrom": null,
      "validUntil": null,
      "netAmount": "string",
      "grossAmount": "string",
      "currency": null,
      "createdAt": "string",
      "convertedOrderId": null
    }
  ],
  "total": 1,
  "dateRange": {
    "from": "string",
    "to": "string"
  }
}
400Invalid query parameters
Content-Type: application/json
{
  "error": "string"
}
401Unauthorized
Content-Type: application/json
{
  "error": "string"
}
403Forbidden
Content-Type: application/json
{
  "error": "string"
}
500Widget failed to load
Content-Type: application/json
{
  "error": "string"
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/dashboard/widgets/new-quotes?limit=5&datePeriod=last24h" \
  -H "Accept: application/json"
GET/sales/delivery-windows
Auth required

List delivery windows

Define delivery windows to communicate lead times and cut-off rules for sales orders.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
searchqueryNoany—
isActivequeryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
withDeletedqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated delivery windows
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "string",
      "code": null,
      "description": null,
      "leadTimeDays": null,
      "cutoffTime": null,
      "timezone": null,
      "isActive": true,
      "metadata": null,
      "organizationId": null,
      "tenantId": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/delivery-windows?page=1&pageSize=50" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/sales/delivery-windows
Auth required

Create delivery window

Creates a new delivery window.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "code": "string"
}

Responses

201Delivery window created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/sales/delivery-windows" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"name\": \"string\",
  \"code\": \"string\"
}"
PUT/sales/delivery-windows
Auth required

Update delivery window

Updates an existing delivery window by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Delivery window updated
Content-Type: application/json
{
  "ok": true
}

Example

curl -X PUT "https://walix-demo.dainamite.com/api/sales/delivery-windows" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
DELETE/sales/delivery-windows
Auth required

Delete delivery window

Deletes a delivery window identified by id.

Request body (application/json)

{
  "id": "00000000-0000-4000-8000-000000000000"
}

Responses

200Delivery window deleted
Content-Type: application/json
{
  "ok": true
}

Example

curl -X DELETE "https://walix-demo.dainamite.com/api/sales/delivery-windows" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"id\": \"00000000-0000-4000-8000-000000000000\"
}"
GET/sales/document-addresses
Auth required

List document addresss

Returns a paginated collection of document addresss that belong to the current organization.

Parameters

NameInRequiredSchemaDescription
pagequeryNoany—
pageSizequeryNoany—
documentIdqueryYesany—
documentKindqueryNoany—
sortFieldqueryNoany—
sortDirqueryNoany—
idsqueryNoanyComma-separated list of record UUIDs to filter by (max 200).

Responses

200Paginated document addresss
Content-Type: application/json
{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "document_id": "00000000-0000-4000-8000-000000000000",
      "document_kind": "order",
      "customer_address_id": null,
      "name": null,
      "purpose": null,
      "company_name": null,
      "address_line1": "string",
      "address_line2": null,
      "building_number": null,
      "flat_number": null,
      "city": null,
      "region": null,
      "postal_code": null,
      "country": null,
      "latitude": null,
      "longitude": null,
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Example

curl -X GET "https://walix-demo.dainamite.com/api/sales/document-addresses?page=1&pageSize=50&documentId=00000000-0000-4000-8000-000000000000" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>"
POST/sales/document-addresses
Auth required

Create document address

Creates a sales document address linked to an order or quote.

Request body (application/json)

{
  "organizationId": "00000000-0000-4000-8000-000000000000",
  "tenantId": "00000000-0000-4000-8000-000000000000",
  "documentId": "00000000-0000-4000-8000-000000000000",
  "documentKind": "order",
  "name": null,
  "purpose": null,
  "companyName": null,
  "addressLine1": "string",
  "addressLine2": null,
  "city": null,
  "region": null,
  "postalCode": null,
  "country": null,
  "buildingNumber": null,
  "flatNumber": null,
  "latitude": null,
  "longitude": null
}

Responses

201Document address created
Content-Type: application/json
{
  "id": null
}

Example

curl -X POST "https://walix-demo.dainamite.com/api/sales/document-addresses" \
  -H "Accept: application/json" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{
  \"organizationId\": \"00000000-0000-4000-8000-000000000000\",
  \"tenantId\": \"00000000-0000-4000-8000-000000000000\",
  \"documentId\": \"00000000-0000-4000-8000-000000000000\",
  \"documentKind\": \"order\",
  \"name\": null,
  \"purpose\": null,
  \"companyName\": null,
  \"addressLine1\": \"string\",
  \"addressLine2\": null,
  \"city\": null,
  \"region\": null,
  \"postalCode\": null,
  \"country\": null,
  \"buildingNumber\": null,
  \"flatNumber\": null,
  \"latitude\": null,
  \"longitude\": null
}"