Teams Members: Retrieve One

This documentation entry provides a clear and detailed guide on how to retrieve a specific team member using the API, including the necessary parameters, headers, and expected response.

Endpoint

GET /api/teams-member/{team_member_id}

Retrieve detailed information about a specific team member by their unique identifier.

Request

HTTP Request

GET https://uptimekeep.com/api/teams-member/{team_member_id}

Replace {team_member_id} with the ID of the team member you wish to retrieve.

Headers

Header	Type	Description
Authorization	String	Bearer token for API authentication.

Example of a request:

curl --request GET \
--url 'https://uptimekeep.com/api/teams-member/{team_member_id}' \
--header 'Authorization: Bearer {api_key}'

Response

A successful response returns a JSON object containing detailed information about the specified team member.

Response Example

{
    "data": {
        "id": 1,
        "access": {
            "read": true,
            "create": true,
            "update": true,
            "delete": false
        },
        "status": 1,
        "last_datetime": "2022-06-07 13:04:31",
        "datetime": "2022-06-05 14:37:10",
        "team_id": 1,
        "name": "Example team"
    }
}

Fields

Data Object

Field	Type	Description
id	Integer	Unique identifier for the team member.
access	Object	Access permissions for the team member (read, create, update, delete).
status	Integer	Status of the team member (e.g., active, inactive).
last_datetime	String	Timestamp of the last activity by the team member (in YYYY-MM-DD HH:MM:SS format).
datetime	String	Timestamp when the team member was added (in YYYY-MM-DD HH:MM:SS format).
team_id	Integer	Unique identifier for the team to which the member belongs.
name	String	Name of the team.

Access Object

Field	Type	Description
read	Boolean	Indicates if the member has read access.
create	Boolean	Indicates if the member has create access.
update	Boolean	Indicates if the member has update access.
delete	Boolean	Indicates if the member has delete access.

Errors

If the request fails, the API will return an error message with an appropriate HTTP status code, such as 404 Not Found if the team member ID does not exist.