Skip to main content
GET
/
v1
/
workspace
/
members
curl -X GET "https://api.caret.so/v1/workspace/members?limit=10&offset=0" \
     -H "X-API-Key: your_api_key_here"

{
  "items": [
    {
      "id": "user_123456789",
      "name": "John Doe",
      "email": "[email protected]",
      "profileUrl": "https://example.com/profile.jpg",
      "role": "admin",
      "createdAt": "2023-01-01T00:00:00Z",
      "folders": [
        {
          "id": "folder_123",
          "name": "Product"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1
  }
}

​
Overview

This endpoint returns a paginated list of members in the workspace. You can filter the results by name or email using the search parameter.

​
Authentication

All API requests must include your API key in the X-API-Key HTTP header. This endpoint requires the users scope.
​
X-API-Key
string
required
Your Caret API key.

​
Query Parameters

​
limit
string
default:"10"
Number of items per page.
​
offset
string
default:"0"
Starting position.
​
search
string
Search by name or email.

​
Response

​
items
object[]
List of workspace members.
​
pagination
object
Pagination metadata.
curl -X GET "https://api.caret.so/v1/workspace/members?limit=10&offset=0" \
     -H "X-API-Key: your_api_key_here"

{
  "items": [
    {
      "id": "user_123456789",
      "name": "John Doe",
      "email": "[email protected]",
      "profileUrl": "https://example.com/profile.jpg",
      "role": "admin",
      "createdAt": "2023-01-01T00:00:00Z",
      "folders": [
        {
          "id": "folder_123",
          "name": "Product"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1
  }
}