Skip to content

Who is in the project

GET
/v1/members
curl --request GET \
--url https://beta-api.plune.ai/v1/members \
--header 'Authorization: Bearer <token>'

Settings → Members (api.ts → listMembers): every member of the current project with their role, oldest first, and every invitation nobody has signed in on yet. Any member may look — the list is how a member finds out who to ask for a role. name is null until people have display names (T3). The dashboard names people by their userId from this list; an id it does not find here it asks about with ?deleted= (#2053), and those of accounts their people deleted — in the Bin, or purged and so in no project any more — come back in deleted and are shown as «deleted account». Only an id this project’s own records name is answered: a member and who invited them, who sent an invitation, a case’s author and assignee, who launched a run, who marked a result, a comment’s author, who added a file, who saved a widget, a review item’s author, editor and reviewers, who saved the AI, storage or CI settings, and a person in the project’s activity log. Any other id is left out of deleted whatever its account, as is a person who only left the project; nothing else about any id is said.

X-Plune-Project
string

Which of your projects to act in — an id from GET /v1/projects. Absent, your default project. A project you are not a member of answers 404, the same as one that does not exist. Ignored under a bearer token, which is bound to the project it was minted in.

deleted
Array<string>
<= 100 items

User ids, comma-separated, at most 100: the answer then carries deleted, those of them that the project’s records name and whose account was deleted.

Members and open invitations

Media type application/json
object
members
required
Array<object>
object
userId
required
string format: uuid
email
required
string format: email
name
required

The display name, once people have one (T3); null until then.

string
nullable
role
required

What a member may do (B8-team, ADR 0050). owner — exactly one a project: its secrets (bucket, CI, AI keys), statuses, name, the move into a company, and the handover of ownership; never demoted or removed, and does not leave — ownership moves only by a handover the recipient accepts. manager runs the people of their level and below: invites as manager, member or reader, and changes and removes members and readers (a manager is demoted and removed by the owner alone). member works in the project and manages nobody; reader is refused every write at the boundary, before a handler runs, but a comment, a pending proposal and leaving the project (#1440, #2055).

string
Allowed values: owner manager member reader
joinedAt
required
string format: date-time
invitedBy
required

Who invited them (a userId); null for the person the project was created by.

string
nullable
deleted

Present while the person’s account waits in the Bin (#952): the place stays until the purge; screens say «deleted account».

boolean
pendingHandover

ADR 0050 §3: on the row of the person the owner asked to take the project over, while the request waits — absent on every other row.

object
id
required
string format: uuid
expiresAt
required
string format: date-time
invitations
required
Array<object>

An address that has been asked and has not signed in since — the sign-in is what turns it into a member.

object
id
required
string format: uuid
email
required
string format: email
role
required

What a member may do (B8-team, ADR 0050). owner — exactly one a project: its secrets (bucket, CI, AI keys), statuses, name, the move into a company, and the handover of ownership; never demoted or removed, and does not leave — ownership moves only by a handover the recipient accepts. manager runs the people of their level and below: invites as manager, member or reader, and changes and removes members and readers (a manager is demoted and removed by the owner alone). member works in the project and manages nobody; reader is refused every write at the boundary, before a handler runs, but a comment, a pending proposal and leaving the project (#1440, #2055).

string
Allowed values: owner manager member reader
invitedBy
required
string
createdAt
required
string format: date-time
pendingMove
required

ADR 0075 §2 (#2244): the move of the project to another company that waits for an answer — null when none does. Seen by whoever sees pendingHandover; its id is the one GET /v1/project-moves/{id} takes, and the owner withdraws it with DELETE /v1/projects/{id}/move.

object
id
required
string format: uuid
toUserId
required

The person asked, as members lists them

string
expiresAt
required
string format: date-time
deleted

Only when ?deleted= asked (#2053): those of the asked user ids that the project’s records name and whose account was deleted — in the Bin or purged. Screens say «deleted account».

Array<string>
Example
{
"members": [
{
"userId": "u-shop",
"email": "owner@example.com",
"name": "Olena Kovalenko",
"role": "owner",
"joinedAt": "2026-09-16T09:12:04.151Z",
"invitedBy": null
},
{
"userId": "6f1c2b3a-0000-4000-8000-0000000000a2",
"email": "colleague@example.com",
"name": null,
"role": "member",
"joinedAt": "2026-09-16T09:12:04.151Z",
"invitedBy": "u-shop"
}
],
"invitations": [
{
"id": "6f1c2b3a-0000-4000-8000-0000000000a3",
"email": "newcomer@example.com",
"role": "reader",
"invitedBy": "u-shop",
"createdAt": "2026-09-16T09:12:04.151Z"
}
],
"pendingMove": null
}

More than 100 ids in deleted

Media type application/json
object
error
required
string
Example
{
"error": "deleted: at most 100 user ids, comma separated"
}

No / invalid token or session

The header names a project you are not in

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}