DCR Policy API
DCR Policy API
Admin APIs for the tenant Dynamic Client Registration (DCR) policy under
/apps-srv/app-management-policies with policyType=dcr.
The same routes also serve other policy types (cimd, developer_portal).
Those payloads differ; this reference focuses on DCR. For CIMD, see the
App Management Policies API.
Requires Trustdesk / admin access. DCR must be enabled for your tenant. When DCR is enabled, registration with an Initial Access Token (IAT) is available. Open registration remains optional and is off by default.
Authentication
| Operation | Scope | Roles |
|---|---|---|
| GET list, GET by id | cidaas:apps_read | ADMIN, SECONDARY_ADMIN |
| PUT create/replace, PATCH, DELETE | cidaas:apps_write | ADMIN, SECONDARY_ADMIN |
Missing or invalid token returns 401. Callers without a required admin
role receive 403 (APP10023).
DCR behaviour
- List (
GET) always returns a JSON array indata. With?type=dcrand DCR disabled, the list is empty (HTTP 200). With DCR enabled and no policy yet, GET creates the seeded default policy (name=default, open registration off, empty allow-lists) and returns it. - Get by id does not create a missing policy. Response includes
dpopEnabledfrom the tenant DPoP feature flag. DCR disabled → 404APP10161. Unknown id → 404APP10125. - PUT for DCR upserts: missing policy → 201 created; existing →
200 replaced. DCR disabled → 404
APP10161. Name must bedefault(400APP10163otherwise). Other validation failures → 400APP10164. - PATCH merges into an existing policy by id.
nameandpolicyTypeare immutable. Same feature and validation codes as PUT. - DELETE is always refused for DCR → 400
APP10162(when the feature is on). Feature off → 404APP10161.
Policy payload (summary)
| Area | Purpose |
|---|---|
openRegistration.enabled | Allow anonymous registration (default false) |
ceilings | What registered clients may use (scopes, grants, redirects, lifetimes, …) |
defaults | Values filled when the registration document omits a field |
secrets.expiresInSeconds | Client-secret lifetime (0 = never; max 1 year) |
limits.maxClientsPerTenant | Cap on DCR apps (0 = unlimited) |
Related documentation
Authentication
- OAuth 2.0: oauth2.0
Security Scheme Type: | oauth2 |
|---|---|
OAuth Flow (authorizationCode): | Token URL: https://domain/token-srv/token Authorization URL: https://domain/authz-srv/authz Scopes:
|
OAuth Flow (clientCredentials): | Token URL: https://domain/token-srv/token Scopes:
|
Contact cidaas support: [email protected]
Terms of Servicehttps://www.cidaas.com/terms-of-use/