API changelog

The generated contract carries info.x-darpan-contract-version, decoupled from the product release version. The policy is additive-only: new methods, new optional parameters, and new response fields ship without a bump; breaking changes require a conscious one. See Contract versioning.

​

Contract version 1

Baseline contract (current).

• JSON-RPC 2.0 transport over POST /rpc/json; HTTP 200 for every dispatched call.
• Auth channels: HttpOnly darpan_login_key cookie plus CSRF token (browser, canonical) and login_key header (integration callers and fallback).
• Method surface as documented in the service catalog.

​

Method surface changes

Added — run observability

• facade.ReconciliationFacadeServices.get#ReconciliationRunStatus
• facade.ReconciliationFacadeServices.cancel#ReconciliationRun
• facade.ReconciliationFacadeServices.subscribe#RunNotification
• facade.ReconciliationFacadeServices.unsubscribe#RunNotification

Added — chat-space notifications

• facade.SettingsFacadeServices.list#TenantChatSpaces
• facade.SettingsFacadeServices.save#TenantChatSpace
• facade.SettingsFacadeServices.delete#TenantChatSpace
• facade.SettingsFacadeServices.get#UserNotificationDefault
• facade.SettingsFacadeServices.save#UserNotificationDefault

Added — connections

• facade.SettingsFacadeServices.test#SourceConnection

Added — Slack notifications

• facade.SlackFacadeServices.begin#SlackInstall
• facade.SlackFacadeServices.save#SlackBotToken
• facade.SlackFacadeServices.get#SlackInstall
• facade.SlackFacadeServices.list#SlackChannels
• facade.SlackFacadeServices.disconnect#SlackWorkspace

A chat space now names a chat product. Existing Google Chat spaces are unaffected. Added — config sharing across tenants

• facade.ConfigSharingFacadeServices.grant#ConfigTenantAccess
• facade.ConfigSharingFacadeServices.revoke#ConfigTenantAccess
• facade.ConfigSharingFacadeServices.list#ConfigTenantAccess

Added — source endpoint access

• facade.SourceEndpointFacadeServices.list#SourceConfigEndpoints
• facade.SourceEndpointFacadeServices.store#SourceConfigEndpointAccess

Added — CSV schema inference

• facade.JsonSchemaFacadeServices.infer#JsonSchemaFromCsvText

Added — automation sync

• facade.ReconciliationFacadeServices.sync#Automation

Re-derives an automation’s snapshot from its saved run. get#Automation gains a syncStatus map reporting snapshot drift; this is an additive response field. Added — expired-password recovery

• facade.AuthFacadeServices.change#ExpiredPassword

Anonymous by necessity — the account cannot hold a session until the password changes — and requires the account’s current password, so it grants no access a caller did not already have. Removed — replaced by the chat-space registry

• facade.SettingsFacadeServices.get#TenantNotificationSettings
• facade.SettingsFacadeServices.save#TenantNotificationSettings

Callers reading or writing the single tenant webhook should move to list#TenantChatSpaces and save#TenantChatSpace. Existing webhooks are carried over automatically on upgrade — see Run-completion alerts.