Members

Inspect organization members, pending invitations, and agent assignments.

List Members

GET

/v1/members

Return the accepted members of the current organization with their role and join date.

Auth: org_owner, security_admin, compliance_auditor, integration_engineer, 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": "2026-01-15T10:30:00.000Z",
      "email": "[email protected]",
      "display_name": "Alice Chen"
    }
  ]
}

List Pending Invitations

GET

/v1/members/invitations

Return invitations with status pending, newest first.

Auth: org_owner, security_admin

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": "[email protected]",
      "role": "compliance_auditor",
      "status": "pending",
      "inviter_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "created_at": "2026-03-10T14:00:00.000Z",
      "expires_at": "2026-03-17T14:00:00.000Z"
    }
  ]
}

List Agent Assignments

GET

/v1/agents/:agent_id/assignments

Return the users assigned to an agent.

Auth: org_owner, security_admin

Response

json

{
  "assignments": [
    {
      "id": "0195a8c9-d0e1-7f2a-b3c4-d5e6f7a8b9c0",
      "agent_id": "agent_underwriter",
      "user_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
      "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "assigned_by": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "created_at": 1772290800000,
      "email": "[email protected]",
      "display_name": "Bob Smith"
    }
  ]
}

Assign a User to an Agent

POST

/v1/agents/:agent_id/assignments

Create an assignment. Returns HTTP 201.

Auth: org_owner, security_admin

Request Body

Field	Type	Required	Description
user_id	string	Yes	Identifier of the organization member to assign

Example Request

bash

curl -X POST https://api.elydora.com/v1/agents/agent_underwriter/assignments \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5" }'

Response

json

{
  "id": "0195a8c9-d0e1-7f2a-b3c4-d5e6f7a8b9c0",
  "agent_id": "agent_underwriter",
  "user_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
  "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
  "assigned_by": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
  "created_at": 1772290800000
}

Remove an Assignment

DELETE

/v1/agents/:agent_id/assignments/:user_id

Delete the assignment between an agent and a user.

Auth: org_owner, security_admin

Response

json

{
  "deleted": true
}

List Agents Assigned to a User

GET

/v1/members/:user_id/agents

Return the agents assigned to one member. Members can read their own list.

Auth: Self, org_owner, security_admin

Response

json

{
  "agents": [
    {
      "id": "0195a8c9-d0e1-7f2a-b3c4-d5e6f7a8b9c0",
      "agent_id": "agent_underwriter",
      "user_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
      "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "assigned_by": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "created_at": 1772290800000,
      "agent_display_name": "Loan Underwriter v2",
      "integration_type": "sdk",
      "agent_status": "active"
    }
  ]
}