Project Membership Events

Project membership events track when users are added to, removed from, or have their roles changed within projects.

project_membership.create

Triggered when a user is added to a project with a specific role. Only project owners can add members.

Event Schema

string

required

Always set to "project_membership.create"

object

required

The user who added the new member

Show properties

string

required

Always set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

string

Email of admin impersonating the user

string

Reason for impersonation

array

required

Three targets: the project, organization membership, and the user being added

Show target objects

object

required

Show properties

string

required

Set to "project"

string

required

Project’s unique identifier

string

required

Project’s name

object

required

Show properties

string

required

Project’s name

string

required

Organization containing the project

object

required

Show properties

string

required

Set to "organization_membership"

string

required

Organization membership identifier

string

required

Member’s full name

object

required

Show properties

string

required

Organization identifier

string

required

Member’s organization role (e.g., "member", "admin")

object

required

Show properties

string

required

Set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

object

required

Show properties

string

required

IP address or "unknown"

string

required

User agent string or "unknown"

object

required

Show properties

string

required

Page route where member was added (e.g., "/projects/{id}/members")

string

required

Project role assigned: "owner", "editor", or "viewer"

Example

{
  "action": "project_membership.create",
  "occurredAt": "2024-11-02T18:30:00.000Z",
  "version": 1,
  "actor": {
    "type": "user",
    "id": "user_01JBKQ8Z...",
    "name": "Alice Johnson",
    "metadata": {
      "first_name": "Alice",
      "last_name": "Johnson",
      "email": "alice@company.com",
      "impersonator_email": "",
      "impersonator_reason": ""
    }
  },
  "targets": [
    {
      "type": "project",
      "id": "proj_abc123",
      "name": "Production API",
      "metadata": {
        "name": "Production API",
        "organization_id": "org_xyz789"
      }
    },
    {
      "type": "organization_membership",
      "id": "om_def456",
      "name": "Bob Smith",
      "metadata": {
        "organization_id": "org_xyz789",
        "role_slug": "member"
      }
    },
    {
      "type": "user",
      "id": "user_02JBKQ9A...",
      "name": "Bob Smith",
      "metadata": {
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "bob@company.com"
      }
    }
  ],
  "context": {
    "location": "203.0.113.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  },
  "metadata": {
    "source": "/projects/proj_abc123/members",
    "role": "editor"
  }
}

project_membership.update

Triggered when a project member’s role is changed. Only project owners can update member roles. Users cannot modify their own membership.

Event Schema

string

required

Always set to "project_membership.update"

object

required

The user who changed the member’s role

Show properties

string

required

Always set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

string

Email of admin impersonating the user

string

Reason for impersonation

array

required

Three targets: the project, organization membership, and the user whose role changed

Show target objects

object

required

Show properties

string

required

Set to "project"

string

required

Project’s unique identifier

string

required

Project’s name

object

required

Show properties

string

required

Project’s name

string

required

Organization containing the project

object

required

Show properties

string

required

Set to "organization_membership"

string

required

Organization membership identifier

string

required

Member’s full name

object

required

Show properties

string

required

Organization identifier

string

required

Member’s organization role

object

required

Show properties

string

required

Set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

object

required

Show properties

string

required

IP address or "unknown"

string

required

User agent string or "unknown"

object

required

Show properties

string

required

Page route where role was updated (e.g., "/projects/{id}/members")

string

required

Previous project role: "owner", "editor", or "viewer"

string

required

New project role: "owner", "editor", or "viewer"

Example

{
  "action": "project_membership.update",
  "occurredAt": "2024-11-02T18:35:00.000Z",
  "version": 1,
  "actor": {
    "type": "user",
    "id": "user_01JBKQ8Z...",
    "name": "Alice Johnson",
    "metadata": {
      "first_name": "Alice",
      "last_name": "Johnson",
      "email": "alice@company.com",
      "impersonator_email": "",
      "impersonator_reason": ""
    }
  },
  "targets": [
    {
      "type": "project",
      "id": "proj_abc123",
      "name": "Production API",
      "metadata": {
        "name": "Production API",
        "organization_id": "org_xyz789"
      }
    },
    {
      "type": "organization_membership",
      "id": "om_def456",
      "name": "Bob Smith",
      "metadata": {
        "organization_id": "org_xyz789",
        "role_slug": "member"
      }
    },
    {
      "type": "user",
      "id": "user_02JBKQ9A...",
      "name": "Bob Smith",
      "metadata": {
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "bob@company.com"
      }
    }
  ],
  "context": {
    "location": "203.0.113.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  },
  "metadata": {
    "source": "/projects/proj_abc123/members",
    "old_role": "viewer",
    "new_role": "editor"
  }
}

project_membership.delete

Triggered when a user is removed from a project. Only project owners can remove members. Users cannot remove themselves.

Event Schema

string

required

Always set to "project_membership.delete"

object

required

The user who removed the member

Show properties

string

required

Always set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

string

Email of admin impersonating the user

string

Reason for impersonation

array

required

Three targets: the project, organization membership, and the user being removed

Show target objects

object

required

Show properties

string

required

Set to "project"

string

required

Project’s unique identifier

string

required

Project’s name

object

required

Show properties

string

required

Project’s name

string

required

Organization containing the project

object

required

Show properties

string

required

Set to "organization_membership"

string

required

Organization membership identifier

string

required

Member’s full name

object

required

Show properties

string

required

Organization identifier

string

required

Member’s organization role

object

required

Show properties

string

required

Set to "user"

string

required

User’s unique identifier

string

required

User’s full name

object

required

Show properties

string

required

User’s first name

string

required

User’s last name

string

required

User’s email address

object

required

Show properties

string

required

IP address or "unknown"

string

required

User agent string or "unknown"

object

required

Show properties

string

required

Page route where member was removed (e.g., "/projects/{id}/members")

string

required

Project role before removal: "owner", "editor", or "viewer"

Example

{
  "action": "project_membership.delete",
  "occurredAt": "2024-11-02T18:40:00.000Z",
  "version": 1,
  "actor": {
    "type": "user",
    "id": "user_01JBKQ8Z...",
    "name": "Alice Johnson",
    "metadata": {
      "first_name": "Alice",
      "last_name": "Johnson",
      "email": "alice@company.com",
      "impersonator_email": "",
      "impersonator_reason": ""
    }
  },
  "targets": [
    {
      "type": "project",
      "id": "proj_abc123",
      "name": "Production API",
      "metadata": {
        "name": "Production API",
        "organization_id": "org_xyz789"
      }
    },
    {
      "type": "organization_membership",
      "id": "om_def456",
      "name": "Bob Smith",
      "metadata": {
        "organization_id": "org_xyz789",
        "role_slug": "member"
      }
    },
    {
      "type": "user",
      "id": "user_02JBKQ9A...",
      "name": "Bob Smith",
      "metadata": {
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "bob@company.com"
      }
    }
  ],
  "context": {
    "location": "203.0.113.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
  },
  "metadata": {
    "source": "/projects/proj_abc123/members",
    "role": "editor"
  }
}

Project Roles

Project memberships use three role levels:

string

Full project access including member management, settings changes, and resource deletion

string

Create and manage API keys and MCP proxies. Cannot manage members or project settings

string

Read-only access to project resources and analytics

Only users who are already members of the organization can be added to projects. Project membership requires existing organization membership.

Common Patterns

Member Addition Flow

Organization owner invites user to organization
Project owner adds organization member to project with specific role
project_membership.create event logs the addition

Permission Changes

Role updates from the project members page create project_membership.update events with before and after roles in metadata. This tracks all permission changes for compliance and security auditing.

Access Removal

When a project owner removes a member, the project_membership.delete event records the user’s role at time of removal. The member retains organization membership but loses project access.

Getting Started

API Reference

Security Concepts

SDKs

Pricing

Monitoring & Logs

Project Membership Events

project_membership.create

Event Schema

Example

project_membership.update

Event Schema

Example

project_membership.delete

Event Schema

Example

Project Roles

Common Patterns

Member Addition Flow

Permission Changes

Access Removal

​project_membership.create

​Event Schema

​Example

​project_membership.update

​Event Schema

​Example

​project_membership.delete

​Event Schema

​Example

​Project Roles

​Common Patterns

​Member Addition Flow

​Permission Changes

​Access Removal

project_membership.create

Event Schema

Example

project_membership.update

Event Schema

Example

project_membership.delete

Event Schema

Example

Project Roles

Common Patterns

Member Addition Flow

Permission Changes

Access Removal