Developer portal

PUT /admin/tenants/{tenant_id}/settings

Merge tenant settings JSON (orgType, salesLed, remediation flags, etc.).

PUT /admin/tenants/{tenant_id}/settingsAuth: admin

Summary

Merge tenant settings JSON (orgType, salesLed, remediation flags, etc.).

Response

{
  "status": "success",
  "tenantId": "acme-bank",
  "settings": {
    "orgType": "mssp",
    "remediationProgramEnabled": true
  }
}

Field	Type	Required	Description
settings	object	Yes	Partial settings object merged into existing tenant settings. e.g. { "orgType": "mssp", "salesLed": true }

Field

Type

Required

Description

settings

object

Yes

Partial settings object merged into existing tenant settings.

e.g. { "orgType": "mssp", "salesLed": true }

Code	Meaning	Typical cause	Suggested fix
404	Not found	Scan, schedule, share link, or resource id does not exist or expired.	Verify id and tenant scope; share links expire per expiresHours.
422	Unprocessable entity	Invalid payload shape, unsupported scenario, or infeasible constraints.	Fix field errors in response detail; relax constraints and retry.
429	Too many requests	Per-key rate limit exceeded (default 300 requests per minute) or public endpoint limit.	Backoff with jitter; cache results; request higher limit for production.
500	Internal server error	Unexpected backend failure; includes requestId in response.	Retry with exponential backoff; contact support with requestId if persistent.