List memberships

curl https://api.usertour.io/v1/users/usr_123456789?expand=memberships \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

{
  "id": "usr_123456789",
  "object": "user",
  "attributes": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "memberships": [
    {
      "id": "mem_123456789",
      "object": "membership",
      "company_id": "comp_123456789",
      "role": "admin",
      "created_at": "2024-03-20T08:30:00.000Z"
    }
  ]
}

GET

company-memberships

curl https://api.usertour.io/v1/users/usr_123456789?expand=memberships \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

{
  "id": "usr_123456789",
  "object": "user",
  "attributes": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "memberships": [
    {
      "id": "mem_123456789",
      "object": "membership",
      "company_id": "comp_123456789",
      "role": "admin",
      "created_at": "2024-03-20T08:30:00.000Z"
    }
  ]
}

Company memberships are accessed through their parent objects (users or companies) using the expansion feature. This design ensures proper data relationships and access control.

Retrieving Memberships

Through Users

To get a user’s memberships:

Fetch the user using the user list endpoint
Include ?expand=memberships in the request URL
The response will include the expanded memberships array

curl https://api.usertour.io/v1/users/usr_123456789?expand=memberships \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

Through Companies

To get a company’s memberships:

Fetch the company using the company list endpoint
Include ?expand=memberships in the request URL
The response will include the expanded memberships array

curl https://api.usertour.io/v1/companies/comp_123456789?expand=memberships \
-H 'Authorization: Bearer ak_123456789' \
-H 'Content-Type: application/json'

Response

The expanded memberships will be included in the response as an array of membership objects.

{
  "id": "usr_123456789",
  "object": "user",
  "attributes": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "memberships": [
    {
      "id": "mem_123456789",
      "object": "membership",
      "company_id": "comp_123456789",
      "role": "admin",
      "created_at": "2024-03-20T08:30:00.000Z"
    }
  ]
}

Remove a membership The content object

API References

Users

Companies

Company Memberships

Content

Content Versions

Content Sessions

Event Definitions

Attribute Definitions

Retrieving Memberships

Through Users

Through Companies

Response

​Retrieving Memberships

​Through Users

​Through Companies

​Response

Retrieving Memberships

Through Users

Through Companies

Response