Members API

The Members API lets you inspect the users who belong to your organization and review pending email invitations. Member data is sourced from the authentication layer and reflects the current state of your workspace in real time.

List Members

GET

/v1/members

Return all accepted members of the current organization, including their role and join date.

Auth: readonly_investigator

Example Request

bash

curl https://api.elydora.com/v1/members \
  -H "Authorization: Bearer <token>"

Response

json

{
  "members": [
    {
      "member_id": "0195a1b2-c3d4-7e5f-a6b7-c8d9e0f1a2b3",
      "user_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "role": "org_owner",
      "joined_at": "2025-01-15T10:30:00.000Z",
      "email": "alice@acme.com",
      "display_name": "Alice Chen"
    },
    {
      "member_id": "0195a2c3-d4e5-7f6a-b7c8-d9e0f1a2b3c4",
      "user_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
      "role": "security_admin",
      "joined_at": "2025-02-01T08:00:00.000Z",
      "email": "bob@acme.com",
      "display_name": "Bob Smith"
    }
  ]
}

List Pending Invitations

GET

/v1/members/invitations

Return all pending (not yet accepted or expired) invitations for the current organization.

Auth: security_admin

Only invitations with a status of pending are returned. Accepted and expired invitations are excluded. Results are ordered by creation time, most recent first.

Example Request

bash

curl https://api.elydora.com/v1/members/invitations \
  -H "Authorization: Bearer <token>"

Response

json

{
  "invitations": [
    {
      "invitation_id": "0195a4e5-f6a7-7b8c-d9e0-f1a2b3c4d5e6",
      "email": "carol@acme.com",
      "role": "compliance_auditor",
      "status": "pending",
      "inviter_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "created_at": "2025-03-10T14:00:00.000Z",
      "expires_at": "2025-03-17T14:00:00.000Z"
    }
  ]
}