Skip to main content

Tango User Roles Reconcile API (non-BU)

Generated from Tango nonBU User Roles Reconcile API Integration Design Specification V0.7.docx in SharePoint folder 01 Common Integrations. OAS spec: user-roles-reconcile-nonbu.yaml

Overview

Async outbound REST API: client retrieves Tango user accounts and their provisioning state for non-BU client environments. Mirrors the BU variant but without the Business Unit layer and with a flatter response shape. Owner: Tango Analytics Spec version: 0.7 Status: Draft (auto-generated — needs review)

Differences from the BU variant

Base URLs

Authentication

Headers x-client + x-api-key.

Endpoints

Filter parameters (mutually exclusive)

Integration logic

Same as the BU variant — batch refresh once per day; data API invokable at most once per day. Status polling unrestricted.

Data model

Per-user record:

Open Questions / Assumptions

  • brands field is a flat string ("Tango Standard") per the source sample. The BU variant has it as a nested-object array. Asymmetric shapes between BU and non-BU variants — confirm intended.
  • roles field sample value is " " (single space). Likely empty access on this sample; confirm whether real records carry role lookup codes here.
  • entity_type values include TARGET, SITE, STORE, PROJECT, LEASE — the BU variant lists TARGET, SITE, LEASE etc. Confirm the complete enum.
  • No audit fields (creation_date / last_login_date etc.) in the non-BU response — the BU variant added these in v0.6. Confirm whether they should be present here too.

Changelog