List your teams
GET /auth/me/teams
Returns the teams you are a direct member of, sorted by name.
You need to be signed in; no capability is needed. Without a session cookie or bearer token that identifies you, the answer is 401, whether or not public mode is on. The operation takes no parameters; any query string is ignored.
Only teams you were added to directly are listed. Teams above or
below them aren’t added, nor are teams you only follow (see
getMyFollowedTeams) or teams where you have a team role or
permission without being a member. Deleted teams are left out. Every
team comes at once, as a plain list with no limit or paging; teams
with the same name come in a fixed order by id.
Each team comes without parents, member_count or
content_count, and hero_asset_id is worked out for you as the
list is read. If the team pictures can’t be checked, the whole
request fails with a server error.
The list is about membership, not permission: what you can do in a team is checked when you act, against your roles and permissions as well as membership, and administrators or people with team-wide permissions can act in teams that aren’t listed here. Membership is read fresh each time, while permission checks can use cached information and disagree with it until that is refreshed. Server errors get a plain-text 500.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Your direct teams, sorted by name; an empty list when you belong to none.
object
The team’s short name, unique among this server’s teams. A deleted team keeps its slug.
Example
aurora-rndExample
Aurora R&DThe server a copied team came from. Left out for this server’s own teams; nothing in the API creates copies.
The team’s picture: fetch it from
/assets/{hero_asset_id}/variants/col. Left out when the team has
no picture you can see, and then clients show the team’s initials.
This is checked on every read, for the person asking. The chosen
asset must still be public, filed under the team and not deleted,
with a col preview on record for its file; if it’s rated mature,
the viewer must own it, have mature content turned on where the
instance allows it, or have system.admin. The choice is kept when
the picture stops qualifying, so it comes back when it qualifies
again. It isn’t shared with other servers.
The team’s direct parents. Sent when one team is returned (an empty list if it has none) and left out of lists. Deleted parents aren’t included, though a parent renamed or deleted since the team last changed can still show as it was.
object
How many direct memberships the team has; members of teams below it
aren’t counted. Only listTeams sends it.
How many assets filed under the team haven’t been deleted. Every one
counts, including drafts and assets you can’t open or that are
hidden from you as mature, so it can be higher than what the team’s
asset list shows you. Posts and collections aren’t counted. Only
listTeams sends it.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}