Get a team member
Answers one person in the shape the team list uses. An agency can read the people of the client companies it manages. Somebody you cannot see answers the same 404 as an id that does not exist.
Path parameters
The id of a user. Digits only; anything else answers 404. At least 1.
Returns
200 The person.
Fields of the 200 answer
A person in a team. Ids are numbers here, unlike in the /user routes.
Fields
At least 1.
The address the person is shown with. For somebody invited who has not accepted, the address they were invited at.
At least 1.
When the invitation expires, in UTC, written with +00:00. Format: date-time.
When the invitation was last sent, in UTC, written with +00:00. Format: date-time.
The person's notification preferences.
Fields
The person's roles, by name.
Fields of each item
The team list holds active, invite_sent and invite_expired; one person read by id can have any of these.
unassignedpending_inviteinvite_sentactiveinactiveinvite_expiredunknownIf it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/team/members/2042 \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/team/members/2042');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/team/members/2042', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/team/members/2042",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"data": {
"company_id": 1204,
"email": "[email protected]",
"id": 2042,
"invitation_expires_at": null,
"invited_at": null,
"name": "Tom Harbour",
"notifications": {
"alerts_notifications": true,
"email_notifications": true,
"maintenance_window_notifications": true,
"subscribe_to_deployment_alerts": true,
"subscribe_to_emergency_alerts": true,
"subscribe_to_newsletters": false
},
"position": "Developer",
"roles": [
{
"name": "Member (Full Access)",
"slug": "client-member-full"
}
],
"status": "active"
}
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}