Skip to content

[LA-35331] Doc team extId on /v1/team_users#41

Merged
tejanium merged 1 commit into
mainfrom
LA-35331/team-users-api-integration-external-id
May 1, 2026
Merged

[LA-35331] Doc team extId on /v1/team_users#41
tejanium merged 1 commit into
mainfrom
LA-35331/team-users-api-integration-external-id

Conversation

@tejanium
Copy link
Copy Markdown

@tejanium tejanium commented Apr 30, 2026

Jira

LA-35331

What

Documents the new integrationExternalId surface on the public Grape v1 Team Users API, added in learnamp/learnamp#22691.

  • Nested routes: noted the parallel /v1/teams/by_external_id/{integrationExternalId}/users subroute under GET, POST, DELETE, and bulk POST sections. Same behaviour as the id-keyed route; unknown / cross-tenant external ids return 404.
  • Flat POST /v1/teams/users: added new teamIntegrationExternalId row to the params table, replaced the "teamId/teamName mutually exclusive" line with the new tri-exclusive rule, and noted the 400 from the CompanyTeamExternalId validator.

Why

Closes the last integrationExternalId gap on the public API. Pairs with the previously-shipped Teams (#38) and Users (#39 / #40) doc updates so non-SCIM HRIS integrations (Specsavers ISC, Akeneo) can manage team membership using their own identifier end-to-end.

@tejanium tejanium marked this pull request as ready for review April 30, 2026 14:39
@tejanium tejanium merged commit 1db0127 into main May 1, 2026
1 check passed
@tejanium tejanium deleted the LA-35331/team-users-api-integration-external-id branch May 1, 2026 09:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants