v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
contributors

Register or update contributor

Register a new contributor or update an existing one (upsert by external_id).

If a contributor with the same external_id exists in this workspace:

  • Updates display_name
  • If the role differs from the current active role, closes the old role and opens a new one

If not found, creates a new contributor with initial role.

post/integrator/workspaces/{workspace_id}/contributors

Path parameters

workspace_idstring uuid required

Request body

external_idstring required

External user ID from integrator

display_namestring required

Display name

Response

Contributor created or updated

contributor_idstring uuid required
workspace_idstring uuid required
external_idstring required
display_namestring required
is_activeboolean required
created_atstring date-time required
updated_atstring date-time required