T
Thomas Mueller
User story
As a developer, I want an OpenAPI file, a scope matrix and consistent IDs, so that integrations can be generated and do not break silently.
Problem / context
The developer portal is a single-page app that tools cannot read. Response schemas, filter operators and scopes per endpoint are missing (field-schema/list returns PERMISSION_DENIED with crm scopes; Social endpoint lacked scopes for months). The list endpoint returns a bare UUID while everything else uses ContactID-<uuid>.
Acceptance criteria
  • Downloadable OpenAPI spec per API.
  • Required scopes listed per endpoint.
  • Response schemas and filter operators with examples.
  • All endpoints return canonical IDs (ContactID-…).