Members

Endpoints for managing members in Linkbreakers. These endpoints allow you to invite, retrieve, update, and delete members.

#The Member object

Describes a teammate invited into a workspace, including their role, login metadata, and last-known activity so Linkbreakers can enforce access policies and audit collaboration.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

GET
/v1/member
Requires auth

#Get the current member

Return the member information associated with the authenticated caller.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

GET
/v1/members
Requires auth

#List members

Retrieve a paginated list of members in the current workspace.

#Parameters

query parameters

pageSize

integer (int64)
query

Maximum number of members to return. Defaults to 100, capped at 1000.

pageToken

string
query

Cursor from a previous response's next_page_token. Empty starts at the first page. Pages are ordered by (created_at, id), which never change, so a record cannot move between pages while a client is walking them.

#Response

200

Everything worked as expected.

members

array<object>

Members included in the current page

nextPageToken

string

Cursor to continue listing members. Empty on the last page.

totalCount

string (int64)

How many members exist in total, so a client can tell a complete answer from a page of one. A local-first client reads absence from this list as the member having been removed, and may only do so when the count it was given matches what it received.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

GET
/v1/members/{id}
Requires auth

#Get a member by ID

Fetch a single workspace member by the provided identifier.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) to retrieve

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

POST
/v1/members/{id}/allow
Requires auth

#Allow access for a member

Restore workspace access for a previously suspended member.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) whose access should be restored

#Request body

No structured schema available for this section.

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

POST
/v1/members/{id}/revoke
Requires auth

#Revoke access for a member

Suspend a member's access without removing their account.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) whose access should be suspended

#Request body

No structured schema available for this section.

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

POST
/v1/members/{id}/signout
Requires auth

#Force a member to sign out

Terminate all active sessions for the specified member.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) to sign out of all sessions

#Request body

No structured schema available for this section.

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

POST
/v1/members/invite
Requires auth

#Invite a new member

Create a pending member and dispatch an invitation email.

#Parameters

This endpoint does not accept any parameters.

#Request body

email

string

Email address of the invitee

firstName

string

First name used in invitation email and dashboard

lastName

string

Last name used in invitation email and dashboard

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

PUT
/v1/member
Requires auth

#Update the current member

Let the signed-in member update their own profile or credentials.

#Parameters

This endpoint does not accept any parameters.

#Request body

email

string

New email address for the signed-in member

firstName

string

First name to display in the product

lastName

string

Last name to display in the product

password

string

Optional password update for the signed-in member

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

PUT
/v1/members/{id}
Requires auth

#Update a member

Modify profile details or role assignments for an existing member.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) to update

#Request body

displayLanguage

string

Preferred language for product copy and emails

email

string

Email address used for login and notifications

firstName

string

First name to display in the product

lastName

string

Last name to display in the product

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

#Response

200

Everything worked as expected.

accessRevokedAt

string (date-time)

When the member's access was revoked (null means active)

accessToken

string

Access token issued during sign-in; returned to clients but not persisted on the member record

createdAt

string (date-time)

Timestamp when the member was created

displayLanguage

string

Preferred language for emails and product copy (BCP-47)

email

string

Email address used as the member's login identifier

emailVerifiedAt

string (date-time)

When the member confirmed ownership of their email address (null means unverified)

firstName

string

Member's given name used in UI surfaces and emails

id

string

Unique identifier for the member record (UUID)

lastKnownCountry

string

Country inferred from geolocation during the most recent sign-in (ISO 3166-1 alpha-2)

lastKnownIp

string

IP address seen on the most recent sign-in

lastKnownLanguage

string

Browser language header captured during the most recent sign-in

lastKnownTimezone

string

Timezone reported during the most recent sign-in (IANA TZ database)

lastName

string

Member's family name used in UI surfaces and emails

lastSigninAt

string (date-time)

Last time the member successfully authenticated

role

string (enum)

Role enumerates the built-in permission tiers that control what teammates can manage inside a workspace.

Allowed values
ROLE_UNSPECIFIED

Role not specified (defaults to viewer permissions)

ROLE_VIEWER
ROLE_ADMIN
ROLE_TECH

updatedAt

string (date-time)

Timestamp when member metadata was last updated

workspaceId

string

Workspace the member belongs to (UUID)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.

DELETE
/v1/members/{id}
Requires auth

#Delete a member

Permanently remove a member from the workspace roster.

#Parameters

path parameters

id

string
Required
path

Member identifier (UUID) to delete

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object
Required

Wrapped error response.