Skip to main content

Add a user to a project

POST 
/projects/:id/members

Adds an org member to the project. Idempotent — re-adding an existing member returns the existing membership record.

Request​

Path Parameters

    id uuidrequired

    Resource UUID.

Body

required

    userIduuidrequired
    Example: 9a8b7c6d-0000-0000-0000-000000000002
    roleOverridestring
    Example: viewer

    externalRef

    object

    providerstringrequired

    Possible values: non-empty

    externalTypestringrequired

    Possible values: non-empty

    externalIdstringrequired

    Possible values: non-empty

    metadata

    object

    property name*any

Created

Schema

    iduuidrequired
    Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
    projectIduuidrequired
    Example: 7b1e2c3d-0000-0000-0000-000000000001
    userIduuidrequired
    Example: 9a8b7c6d-0000-0000-0000-000000000002
    roleOverridestring | nullnullablerequired

    Optional role override for this project. Null = inherits org role.

    Example: viewer

    metadata

    object,null

    required

    Provider-supplied metadata.

    property name*anynullable

    Provider-supplied metadata.

    createdAtdate-timerequired
    Example: 2025-01-01T00:00:00Z