API reference

Members

Programmatic access to the same membership operations available in the admin console.

The member object

member

{
  "id":            "mem_01HZX...",
  "user_id":       "usr_01HZX...",
  "workspace_id":  "ws_01HZX...",
  "email":         "aria@acme.com",
  "name":          "Aria Chen",
  "role":          "contributor",
  "status":        "active",
  "joined_at":     "2026-02-04T09:11:42Z",
  "last_seen_at":  "2026-05-19T08:01:00Z"
}

POST /v1/members

Invite a new member.

Field	Type	Note
email	string	Required. Must match an SSO domain when SSO-only is on.
role	string	owner, admin, curator, contributor, viewer.
project_ids	string[]	Optional. Restricts initial access.
invite_message	string	Optional. Up to 500 chars; included in the email.

curl

curl -X POST https://api.mnemos.ai/v1/members \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "aria@acme.com",
    "role": "contributor",
    "project_ids": ["prj_01HZX..."]
  }'

GET /v1/members

List members. Query params: role, status, project_id, cursor, limit.

curl

curl 'https://api.mnemos.ai/v1/members?role=curator' \
  -H "Authorization: Bearer $MNEMOS_API_KEY"

PATCH /v1/members/{id}

Update a member's role.

curl

curl -X PATCH https://api.mnemos.ai/v1/members/mem_01HZX... \
  -H "Authorization: Bearer $MNEMOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "role": "admin" }'

DELETE /v1/members/{id}

Remove a member. Equivalent to SCIM active=false. Sessions and personal API keys are revoked immediately.