Users

Add an allowlisted user to a board (workspace admin role and admin token scope)

post/api/boards/{boardId}/members

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/boards/{boardId}/members
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Opaque 1–200 character key. The same user, endpoint, and key replay the cached response for 24 hours when the request body fingerprint matches. A reused key with a different body answers 422 IDEMPOTENCY_KEY_REUSED; the same key while the original is still in flight answers 409 CONFLICT.

Request body

emailstring email required
role'editor' | 'viewer' required

Response

Success

userIdstring uuid required
emailstring email required
namestring nullable required
role'editor' | 'viewer' required
createdAtstring date-time

When the membership began. The list carries it; the add answer does not.

Changes

No recorded changes to this operation across all 1 revision of this API.