Update App
Partially update an App. Omitted fields remain unchanged. Updating auth_config or tenant metadata invalidates the cached provider token immediately. Providers using the OAuth callback reject auth_config and must be reauthorized through connect-app.
Authorizations
Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"
Path Parameters
Body
Per-tenant API base URL.
Sub-account id, for providers that scope requests by a sub-account id on a shared host.
Caller-managed credentials. Providers using the OAuth callback reject auth_config and must be authorized through connect-app.
- Option 1
- Option 2
- Option 3
Response
Updated App.
App integration category.
crm, calendar, knowledge_base, support, communication Provider name. Must be valid for the App's type; the supported providers per type are listed by list-app-templates.
Connection health of the App, server-managed. not_connected after create or a credential / tenant URL change; connected once verified via OAuth connect, an auth test, or a successful live tool call; error when the provider rejects the credentials (on connect, an auth test, or a live tool call).
not_connected, connected, error Per-tenant API base URL. Set by providers with per-org hosts; omitted by providers on a single global host. For OneDrive for Business, this is the tenant's -my.sharepoint.com origin used by File Picker v8; personal OneDrive omits it.
Microsoft OneDrive account type discovered during OAuth.
business, personal Sub-account id, for providers that scope requests by a sub-account id on a shared host. Omitted by every other provider.
Non-secret auth metadata. Encrypted secret fields are never returned by the API.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5

