Teams

Auto Compose Suggest

Propose a team structure from the organisation's current universe.

THIS SPENDS CREDITS. It reads every member, mailbox, number, campaign and sequence and runs a model over them, and the handler settles the usage afterwards - which is why it gates on team:run rather than plain write.

It SUGGESTS only. Nothing is created until you send the result to POST /teams.

post/teams/auto-compose/suggest

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/teams/auto-compose/suggest
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataOrgPayload required

An open envelope for a single role, team, member or account record.

Open on purpose. The app's own response models on this surface grow with the product - RoleResponse gained rep_limits and manages_role_slugs, TeamResponse gained channel counts and a campaign count - and a pinned mirror would SILENTLY DROP whatever it had not caught up on. A dropped permission in a role read is the worst possible kind of stale: it reads as "they do not have it".

Changes

No recorded changes to this operation across all 2 revisions of this API.