> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://onepin.ai/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://onepin.ai/docs/_mcp/server. # List Members GET https://api.onepin.ai/api/v1/workspaces/{ws_id}/members List active members and pending invites for a workspace. Returns a unified list combining confirmed members (status `active`) and outstanding invites that have not yet been accepted or revoked (status `invited`). Pending invites appear with `user_id: null` and only the `email` and `role` fields populated. The list is sorted: the requesting user appears first, then admins by join date, then other members by join date. No pagination — the full roster is returned in a single response. Roles: - `admin`: can manage members, invites, workspace settings, and all content. - `editor`: can create, edit, and run workflows; cannot manage members. - `viewer`: read-only access to workspace content and run history. Reference: https://onepin.ai/docs/reference/api-reference/workspace-members/list-members-api-v-1-workspaces-ws-id-members-get ## Authentication - `Authorization` header (bearer token, required) — Clerk JWT token ## Servers - `https://api.onepin.ai` (prod, default) - `https://dev-api.onepin.ai` (dev) ## Request ### Path parameters - `ws_id` (string, required) ## Response ### 200 Successful Response - `data` (list of WorkspaceMemberOut, required) - `meta` (Meta, required) - `pagination` (PaginationMeta, required) ## Errors ### 422 Unprocessable Entity Error Validation Error - `detail` (list of ValidationError, optional) ## Types ### WorkspaceMemberOut - `id` (string, required) — Member or invite record ID. - `user_id` (string, required, nullable) — User ID of the member. Null for pending invites (invitee has not yet accepted). - `email` (string, required) — Email address. For active members this is their primary account email; for invites it is the address the invite was sent to. - `first_name` (string, required, nullable) — First name. Null for pending invites. - `last_name` (string, required, nullable) — Last name. Null for pending invites. - `image_url` (string, required, nullable) — Profile image URL. Null for pending invites. - `role` (string, required) — Workspace role: `admin`, `editor`, or `viewer`. - `last_active_at` (datetime, required, nullable) — When the member last accessed the workspace (UTC). Null for pending invites. - `status` (string, required) — Membership status: `active` for confirmed members, `invited` for pending invites. ### Meta - `request_id` (string, required) - `timestamp` (datetime, required) ### PaginationMeta - `limit` (integer, required) - `next` (string, optional, nullable) - `prev` (string, optional, nullable) ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) - `input` (any, optional) - `ctx` (ValidationErrorCtx, optional) ### ValidationErrorLocItems ### ValidationErrorCtx ## Examples **Request** ```json {} ``` **Response** ```json { "data": [ { "id": "a3f1c9e2-4b7d-4f2a-9c3e-1d2b5f6a7e8c", "user_id": "d9f8a7b6-c5e4-3d2c-1b0a-9f8e7d6c5b4a", "email": "jane.doe@example.com", "first_name": "Jane", "last_name": "Doe", "image_url": "https://cdn.onepin.ai/profiles/jane_doe.png", "role": "admin", "last_active_at": "2024-04-20T14:22:00Z", "status": "active" }, { "id": "b7e6d5c4-3f2a-1b0c-9d8e-7f6a5b4c3d2e", "user_id": "c4d3e2f1-0a9b-8c7d-6e5f-4a3b2c1d0e9f", "email": "michael.smith@example.com", "first_name": "Michael", "last_name": "Smith", "image_url": "https://cdn.onepin.ai/profiles/michael_smith.jpg", "role": "admin", "last_active_at": "2024-04-18T09:15:00Z", "status": "active" }, { "id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f", "user_id": "e7f8a9b0-c1d2-3e4f-5a6b-7c8d9e0f1a2b", "email": "lisa.jones@example.com", "first_name": "Lisa", "last_name": "Jones", "image_url": "https://cdn.onepin.ai/profiles/lisa_jones.png", "role": "editor", "last_active_at": "2024-04-19T11:45:00Z", "status": "active" }, { "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90", "user_id": null, "email": "new.member@example.com", "first_name": null, "last_name": null, "image_url": null, "role": "viewer", "last_active_at": null, "status": "invited" } ], "meta": { "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "timestamp": "2024-04-20T15:00:00Z" }, "pagination": { "limit": 100, "next": null, "prev": null } } ``` **SDK Code** ```python import requests url = "https://api.onepin.ai/api/v1/workspaces/ws_id/members" payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.get(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.onepin.ai/api/v1/workspaces/ws_id/members'; const options = { method: 'GET', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.onepin.ai/api/v1/workspaces/ws_id/members" payload := strings.NewReader("{}") req, _ := http.NewRequest("GET", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.onepin.ai/api/v1/workspaces/ws_id/members") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.onepin.ai/api/v1/workspaces/ws_id/members") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('GET', 'https://api.onepin.ai/api/v1/workspaces/ws_id/members', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.onepin.ai/api/v1/workspaces/ws_id/members"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.onepin.ai/api/v1/workspaces/ws_id/members")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```