DocumentaciónEngagement Platform API
Sign inGet started
Guides
API

Users

GET
/organizations/{organizationId}/users
Get a list of members for an organization.
Parámetros de consulta
limit
integer
Limits the number of results to return.
pageToken
string
The cursor that keeps track of the current position in the results.
reverse
boolean
Reverses the order in which the results are returned.
preview
boolean
searchTerm
string
Search term used to filter organizations by name
userIds
array
List of user IDs.
email
string
Get an organization membership for this email address. Exact matching only.
status
string
Filter organization memberships by their status.
Possible values: banned, invited, active
role
array
Filter organization memberships by their role.
Cuerpo de la respuesta
results
array of object
obligatorio
Mostrar atributos secundarios
results.user
object
obligatorio
Mostrar atributos secundarios
A user on the platform.
results.user.activeSessions
integer
obligatorio
The number of logged in session for the user.
results.user.avatarUrl
string
URL to the user's profile picture.
results.user.badges
array of string
results.user.bio
string
The user's description
results.user.createdAt
string
obligatorio
When the user was created.
results.user.defaultEmail
string
The default email of the user in the list of emails.
results.user.emails
array of object
obligatorio
Email addresses associated with user.
Mostrar atributos secundarios
results.user.emails.createdAt
string
obligatorio
When this record was created.
results.user.emails.email
string
obligatorio
The email address.
results.user.emails.id
string
obligatorio
ID of the email record.
results.user.emails.passwordSet
boolean
obligatorio
Whether there is a password set for this email address.
results.user.emails.tokenSet
boolean
obligatorio
Whether there is a token set for this email address.
results.user.emails.updatedAt
string
When this record was last updated.
results.user.emails.userId
string
obligatorio
ID of the user this record is associated with.
results.user.emails.verified
boolean
obligatorio
Whether the email address is verified.
results.user.id
string
obligatorio
ID of the user
results.user.identities
array of object
Third-party identities associated with user.
Mostrar atributos secundarios
results.user.identities.avatarUrl
string
The avatar URL of the user on the third-party provider.
results.user.identities.createdAt
string
Timestamp when the identity was created.
results.user.identities.email
string
The email of the user on the third-party provider.
results.user.identities.id
string
The ID of the user on the third-party provider.
results.user.identities.name
string
The name of the user on the third-party provider.
results.user.identities.provider
string
The name of the provider
results.user.identities.updatedAt
string
Timestamp when the identity was last updated.
results.user.locale
string
results.user.name
string
obligatorio
The display name for the user
results.user.phoneNumber
string
results.user.phoneNumbers
array of object
obligatorio
The phone numbers associated with the user.
Mostrar atributos secundarios
results.user.phoneNumbers.createdAt
string
obligatorio
results.user.phoneNumbers.id
string
obligatorio
results.user.phoneNumbers.phoneNumber
string
obligatorio
results.user.phoneNumbers.primary
boolean
obligatorio
results.user.phoneNumbers.updatedAt
string
obligatorio
results.user.phoneNumbers.userId
string
obligatorio
results.user.phoneNumbers.verified
boolean
obligatorio
results.user.status
string
obligatorio
The status of the user
Possible values: pending, active, deleted, invited, banned
results.user.timezone
string
The default timezone for the user.
results.user.updatedAt
string
obligatorio
When the user was last updated.
results.user.userFraudInformation
object
Mostrar atributos secundarios
results.user.userFraudInformation.score
number
Fraud score
results.user.userFraudInformation.userId
string
Fraud user id
results.status
string
obligatorio
The status of user's membership on the organization.
Possible values: banned, invited, active
results.createdAt
string
obligatorio
When the membership was created.
results.updatedAt
string
obligatorio
When the membership was last updated.
results.attributes
object
Authorization context for the membership.
results.roleIds
array of string
IDs of IAM roles assigned to the user.
results.roleRefs
array of object
The list of roles to assign to the membership
Mostrar atributos secundarios
results.roleRefs.id
string
obligatorio
results.roleRefs.type
string
obligatorio
Possible values: organization, managed
results.roleRefs.workspaces
array of string
nextPageToken
string
The token to fetch the next page of results. If empty, there are no more results to fetch.
Ejemplo de código
curl -X GET 'https://api.bird.com/organizations/{organizationId}/users' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
POST
/organizations/{organizationId}/users
Add a user to an organization. This can either be an existing user, or a new user that is invited to the platform.
Cuerpo de la solicitud
Add an existing user to the organization
userId
string
obligatorio
The user ID
roleRefs
array of object
The list of roles to assign to the membership
Mostrar parámetros secundarios
roleRefs.id
string
obligatorio
roleRefs.type
string
obligatorio
Possible values: organization, managed
roleRefs.workspaces
array of string
roleIds
array of string
The list of Role IDs to assign to the user
attributes
object
Structured attributes for organization user membership (preferred method)
Mostrar parámetros secundarios
attributes.roles
array of string
List of role slugs (consistent with workspace users)
Ejemplo de código
curl -X POST 'https://api.bird.com/organizations/{organizationId}/users' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
GET
/organizations/{organizationId}/users/{userId}
Get a single organization membership record.
Parámetros de consulta
preview
boolean
Cuerpo de la respuesta
user
object
obligatorio
Mostrar atributos secundarios
A user on the platform.
user.activeSessions
integer
obligatorio
The number of logged in session for the user.
user.avatarUrl
string
URL to the user's profile picture.
user.badges
array of string
user.bio
string
The user's description
user.createdAt
string
obligatorio
When the user was created.
user.defaultEmail
string
The default email of the user in the list of emails.
user.emails
array of object
obligatorio
Email addresses associated with user.
Mostrar atributos secundarios
user.emails.createdAt
string
obligatorio
When this record was created.
user.emails.email
string
obligatorio
The email address.
user.emails.id
string
obligatorio
ID of the email record.
user.emails.passwordSet
boolean
obligatorio
Whether there is a password set for this email address.
user.emails.tokenSet
boolean
obligatorio
Whether there is a token set for this email address.
user.emails.updatedAt
string
When this record was last updated.
user.emails.userId
string
obligatorio
ID of the user this record is associated with.
user.emails.verified
boolean
obligatorio
Whether the email address is verified.
user.id
string
obligatorio
ID of the user
user.identities
array of object
Third-party identities associated with user.
Mostrar atributos secundarios
user.identities.avatarUrl
string
The avatar URL of the user on the third-party provider.
user.identities.createdAt
string
Timestamp when the identity was created.
user.identities.email
string
The email of the user on the third-party provider.
user.identities.id
string
The ID of the user on the third-party provider.
user.identities.name
string
The name of the user on the third-party provider.
user.identities.provider
string
The name of the provider
user.identities.updatedAt
string
Timestamp when the identity was last updated.
user.locale
string
user.name
string
obligatorio
The display name for the user
user.phoneNumber
string
user.phoneNumbers
array of object
obligatorio
The phone numbers associated with the user.
Mostrar atributos secundarios
user.phoneNumbers.createdAt
string
obligatorio
user.phoneNumbers.id
string
obligatorio
user.phoneNumbers.phoneNumber
string
obligatorio
user.phoneNumbers.primary
boolean
obligatorio
user.phoneNumbers.updatedAt
string
obligatorio
user.phoneNumbers.userId
string
obligatorio
user.phoneNumbers.verified
boolean
obligatorio
user.status
string
obligatorio
The status of the user
Possible values: pending, active, deleted, invited, banned
user.timezone
string
The default timezone for the user.
user.updatedAt
string
obligatorio
When the user was last updated.
user.userFraudInformation
object
Mostrar atributos secundarios
user.userFraudInformation.score
number
Fraud score
user.userFraudInformation.userId
string
Fraud user id
status
string
obligatorio
The status of user's membership on the organization.
Possible values: banned, invited, active
createdAt
string
obligatorio
When the membership was created.
updatedAt
string
obligatorio
When the membership was last updated.
roleIds
array of string
IDs of IAM roles assigned to the user.
roleRefs
array of object
The list of roles to assign to the membership
Mostrar atributos secundarios
roleRefs.id
string
obligatorio
roleRefs.type
string
obligatorio
Possible values: organization, managed
roleRefs.workspaces
array of string
teamRoles
array of object
The list of roles inherited from teams
Mostrar atributos secundarios
teamRoles.id
string
obligatorio
teamRoles.name
string
obligatorio
teamRoles.roleRefs
array of object
The list of roles assigned to the team
Mostrar atributos secundarios
teamRoles.roleRefs.id
string
obligatorio
teamRoles.roleRefs.type
string
obligatorio
Possible values: organization, managed
teamRoles.roleRefs.workspaces
array of string
attributes
object
Additional attributes for the membership
Ejemplo de código
curl -X GET 'https://api.bird.com/organizations/{organizationId}/users/{userId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
DELETE
/organizations/{organizationId}/users/{userId}
Remove a user from the organization
Ejemplo de código
curl -X DELETE 'https://api.bird.com/organizations/{organizationId}/users/{userId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
PATCH
/organizations/{organizationId}/users/{userId}
Update the properties of the organization membership for the user.
Cuerpo de la solicitud
roleRefs
array of object
The list of roles to assign to the membership (legacy, use attributes instead)
Mostrar parámetros secundarios
roleRefs.id
string
obligatorio
roleRefs.type
string
obligatorio
Possible values: organization, managed
roleRefs.workspaces
array of string
roleIds
array of string
Roles to assign to the user (legacy, use attributes instead)
attributes
object
Structured attributes for organization user membership (preferred method)
Mostrar parámetros secundarios
attributes.roles
array of string
List of role slugs (consistent with workspace users)
roleTreatment
string
Used to allow removing the legacy roles for the user
Cuerpo de la respuesta
user
object
obligatorio
Mostrar atributos secundarios
A user on the platform.
user.activeSessions
integer
obligatorio
The number of logged in session for the user.
user.avatarUrl
string
URL to the user's profile picture.
user.badges
array of string
user.bio
string
The user's description
user.createdAt
string
obligatorio
When the user was created.
user.defaultEmail
string
The default email of the user in the list of emails.
user.emails
array of object
obligatorio
Email addresses associated with user.
Mostrar atributos secundarios
user.emails.createdAt
string
obligatorio
When this record was created.
user.emails.email
string
obligatorio
The email address.
user.emails.id
string
obligatorio
ID of the email record.
user.emails.passwordSet
boolean
obligatorio
Whether there is a password set for this email address.
user.emails.tokenSet
boolean
obligatorio
Whether there is a token set for this email address.
user.emails.updatedAt
string
When this record was last updated.
user.emails.userId
string
obligatorio
ID of the user this record is associated with.
user.emails.verified
boolean
obligatorio
Whether the email address is verified.
user.id
string
obligatorio
ID of the user
user.identities
array of object
Third-party identities associated with user.
Mostrar atributos secundarios
user.identities.avatarUrl
string
The avatar URL of the user on the third-party provider.
user.identities.createdAt
string
Timestamp when the identity was created.
user.identities.email
string
The email of the user on the third-party provider.
user.identities.id
string
The ID of the user on the third-party provider.
user.identities.name
string
The name of the user on the third-party provider.
user.identities.provider
string
The name of the provider
user.identities.updatedAt
string
Timestamp when the identity was last updated.
user.locale
string
user.name
string
obligatorio
The display name for the user
user.phoneNumber
string
user.phoneNumbers
array of object
obligatorio
The phone numbers associated with the user.
Mostrar atributos secundarios
user.phoneNumbers.createdAt
string
obligatorio
user.phoneNumbers.id
string
obligatorio
user.phoneNumbers.phoneNumber
string
obligatorio
user.phoneNumbers.primary
boolean
obligatorio
user.phoneNumbers.updatedAt
string
obligatorio
user.phoneNumbers.userId
string
obligatorio
user.phoneNumbers.verified
boolean
obligatorio
user.status
string
obligatorio
The status of the user
Possible values: pending, active, deleted, invited, banned
user.timezone
string
The default timezone for the user.
user.updatedAt
string
obligatorio
When the user was last updated.
user.userFraudInformation
object
Mostrar atributos secundarios
user.userFraudInformation.score
number
Fraud score
user.userFraudInformation.userId
string
Fraud user id
status
string
obligatorio
The status of user's membership on the organization.
Possible values: banned, invited, active
createdAt
string
obligatorio
When the membership was created.
updatedAt
string
obligatorio
When the membership was last updated.
attributes
object
Authorization context for the membership.
roleIds
array of string
IDs of IAM roles assigned to the user.
roleRefs
array of object
The list of roles to assign to the membership
Mostrar atributos secundarios
roleRefs.id
string
obligatorio
roleRefs.type
string
obligatorio
Possible values: organization, managed
roleRefs.workspaces
array of string
Ejemplo de código
curl -X PATCH 'https://api.bird.com/organizations/{organizationId}/users/{userId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'