App Configuration API

Manage OAuth2/OIDC applications through the app configuration model used by Trustdesk (Integrations → Applications).

These APIs replace the flat legacy payload on /apps-srv/clients with structured configuration (redirect_uris, scopes, authentication_setup, external references such as hosted_pages_layout_id and user_setup_id, and more).

Requires Trustdesk.

Client secret and signing-key rotation, and app search, are also managed here (/apps-srv/apps/{clientID}/secrets*, /apps-srv/apps/{clientID}/signing-key/rotate, /apps-srv/apps/-/search).

Related documentation

App management
Rotating secrets and signing keys
Introducing Trustdesk
The legacy client API (/apps-srv/clients) is no longer publicly documented; existing integrations continue to work unchanged, but new integrations should use this API. Scope management remains on the Scope Management API (/scopes-srv/scope), which is unrelated to app configuration.

Referenced configuration APIs (IDs stored on the application, owned by other services)

User App Setup API — user_setup_id → GET /user-srv/usersetup/{id}
Hosted Page Layouts — hosted_pages_layout_id → GET /hostedpages-srv/hosted-page-layouts/{id}
Field Setup API — field keys referenced by User App Setup profiles
Hosted Pages Groups API — page sets linked via layout.hosted_page_group on a layout
Verification Options API — verification_options_id → GET /verification-actions-srv/verification-options/{id}
Group Role Restrictions — group_verification_request_id → GET /groups-srv/verifications/requests/{id}

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: cidaas:apps_read: Read app configurations cidaas:apps_write: Create or update app configurations cidaas:apps_delete: Delete app configurations
OAuth Flow (clientCredentials):	Token URL: https://domain/token-srv/token Scopes: cidaas:apps_read: Read app configurations cidaas:apps_write: Create or update app configurations cidaas:apps_delete: Delete app configurations

Contact

cidaas support: [email protected]

URL: https://support.cidaas.com

Terms of Service

https://www.cidaas.com/terms-of-use/

App Configuration API