Returns the team member with the given identifier.

GET /psa/team-members/{id}

Group: PSA › Team Members · Operation ID: getTeamMember

An entry in the roster is one person on a PSA project's team. This route returns the roster row, not the person's position assignments, which are a separate resource.

Open in the interactive reference

Parameters

Name In Type Required Description
Api-Version header "v1" yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
id path string yes The unique identifier for the team-roster row to return.

Response

200 Success

Under data (getTeamMemberOutput):

Field Type Required Description
id string yes The unique identifier for the team-roster row.
psaProjectId number no The id of the PSA project this record belongs to. It is a numeric package-layer key you can filter on here, not the UUID that GET psa/projects/:id takes.
employeeId number yes The id of the employee this roster row is for. It is a numeric package-layer key, not a UUID any public endpoint returns as a fetchable id.
isTeamLead boolean no Whether this team member is the team lead.
startDate string (date) no The first day of this person's membership of the team. Format YYYY-MM-DD. Absent when not set.
endDate string (date) no The last day of this person's membership of the team. Format YYYY-MM-DD. Absent when not set.
allocation string (decimal) no The share of the person's capacity allocated to this team, as a percentage. For example, 50 means 50%.
name string no The full name of the team member. It is returned but cannot be filtered or sorted on, and there is no endpoint to find a member by name.
displayName string no The preferred display name of the team member. Like name, it cannot be filtered or sorted on.
lastModifiedDate string (date-time) yes The date and time this roster row last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.

Errors

Code Status
NOT_FOUND 400

Statuses