Skip to content

[LA-35267] Doc team extId on /api/v1/users#39

Merged
tejanium merged 1 commit into
mainfrom
LA-35267/users-api-team-integration-external-id
Apr 30, 2026
Merged

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

Conversation

@tejanium
Copy link
Copy Markdown

@tejanium tejanium commented Apr 29, 2026

Jira

LA-35267

What

Documents the new team-by-integrationExternalId params on the public Grape v1 Users API, added in learnamp/learnamp#22631.

  • New rows in the Create-user and Update-user body tables:
    • primaryTeamIntegrationExternalId (String) — mutually exclusive with primaryTeamId.
    • secondaryTeamIntegrationExternalIds (Array[String]) — mutually exclusive with secondaryTeamIds.
  • New 400 examples on POST /api/v1/users:
    • must match existing teams integration external IDs from the new CompanyTeamExternalId validator.
    • mutually_exclusive error when both id-keyed and extId-keyed team params are sent together.

Why

Companion to LA-35266 (api-docs#38) which documented integrationExternalId on the Teams API. Third-party integrations shouldn't need the LA-internal team.id when provisioning users either.

@tejanium tejanium marked this pull request as ready for review April 30, 2026 09:06
@tejanium tejanium merged commit 4aa4fbc into main Apr 30, 2026
1 check passed
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