Get team member
GET/v2/orgs/:org_id/teams/:team_id/members/:member_id
Retrieves team member by id.
Required scope
organizations:teams:readRate limiting
Level 1Enterprise only
This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Company Admin. You can request temporary access to Enterprise APIs using this form.
Request
Path Parameters
The id of the Organization.
The id of the Team.
The id of the Team Member
Responses
- 200
- 400
- 401
- 403
- 404
- 429
Team member object
- application/json
- Schema
- Example (from schema)
Schema
- "member": Team member with full member permissions.
- "admin": Admin of a team. Team member with permission to manage team.
- "non_team": External user, non-team user.
- "team_guest": Team-guest user, user with access only to a team without access to organization.
Team member id.
Possible values: [non_team
, member
, admin
, team_guest
]
Role of the team member.
Date and time when member was invited to the team.
Id of the user who invited the team member.
Date and time when the user's membership was last updated.
Id of the user who last updated the user's membership.
Team id
Default value: team-member
Type of the object returned.
{
"id": "3074457345618264000",
"role": "non_team",
"createdAt": "2024-04-11T15:04:04.389Z",
"createdBy": "3074457345618264000",
"modifiedAt": "2024-04-11T15:04:04.389Z",
"modifiedBy": "3074457345618264000",
"teamId": "3074457345618265000",
"type": "team-member"
}
Malformed request
- application/json
- Schema
- Example (from schema)
Schema
Default value: 400
HTTP status code.
Default value: invalidParameters
Description of the status code.
Explanation for the error
Default value: error
Type of the object returned.
{
"status": 400,
"code": "invalidParameters",
"message": "string",
"type": "error"
}
Invalid authentication credentials
- application/json
- Schema
- Example (from schema)
Schema
Default value: 401
HTTP status code.
Default value: tokenNotProvided
Description of the status code.
Explanation for the error
Default value: error
Type of the object returned.
{
"status": 401,
"code": "tokenNotProvided",
"message": "string",
"type": "error"
}
Invalid access
- application/json
- Schema
- Example (from schema)
Schema
Default value: 403
HTTP status code.
Default value: forbiddenAccess
Description of the status code.
Explanation for the error
Default value: error
Type of the object returned.
{
"status": 403,
"code": "forbiddenAccess",
"message": "string",
"type": "error"
}
Invalid access
- application/json
- Schema
- Example (from schema)
Schema
Default value: 404
HTTP status code.
Default value: notFound
Description of the status code.
Explanation for the error
Default value: error
Type of the object returned.
{
"status": 404,
"code": "notFound",
"message": "string",
"type": "error"
}
Too many requests
- application/json
- Schema
- Example (from schema)
Schema
Default value: 429
HTTP status code.
Default value: tooManyRequests
Description of the status code.
Explanation for the error
Default value: error
Type of the object returned.
{
"status": 429,
"code": "tooManyRequests",
"message": "string",
"type": "error"
}