Skip to content
Plune Plune Docs

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).

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
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.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

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). owner runs the project — members, roles, its name; member does everything else; reader is refused every write at the boundary, before a handler runs.

string
Allowed values: owner 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
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). owner runs the project — members, roles, its name; member does everything else; reader is refused every write at the boundary, before a handler runs.

string
Allowed values: owner member reader
invitedBy
required
string
createdAt
required
string format: date-time
Example 
{
  "members": [
    {
      "userId": "u-shop",
      "email": "[email protected]",
      "name": "Olena Kovalenko",
      "role": "owner",
      "joinedAt": "2026-09-16T09:12:04.151Z",
      "invitedBy": null
    },
    {
      "userId": "6f1c2b3a-0000-4000-8000-0000000000a2",
      "email": "[email protected]",
      "name": null,
      "role": "member",
      "joinedAt": "2026-09-16T09:12:04.151Z",
      "invitedBy": "u-shop"
    }
  ],
  "invitations": [
    {
      "id": "6f1c2b3a-0000-4000-8000-0000000000a3",
      "email": "[email protected]",
      "role": "reader",
      "invitedBy": "u-shop",
      "createdAt": "2026-09-16T09:12:04.151Z"
    }
  ]
}

401

Section titled “401 ”

No / invalid token or session

404

Section titled “404 ”

The header names a project you are not in

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