Members
Members are your workspace's team, each an owner or an admin. The API lists them; you invite members and change their roles in the dashboard, under Settings → Team.
The examples read your API key and your workspace's base URL from two shell variables. Set them once, with your workspace's id in place of ws_... (API keys says where to find both):
export SWINGBACK_API_KEY="s_live_..."
export SWINGBACK_API="https://api.swingback.dev/v1/workspaces/ws_..." List members#
/ v1/ workspaces/ {workspace_id}/ membersAny API key: Read or Read and write
Returns the workspace's team members, the earliest to join first.
Path parameters
workspace_idstringrequiredYour workspace's id, shown under Settings → Sign-in.
Starts with
ws_
Query parameters
limitintegerHow many items to return in the page.
From 1 to 100Defaults to
25cursorstringThe previous page's
next_cursor, to get the next page.At most 1,024 characters
Responses
- 200OKA page of members. The member objects are in
data(see Pagination). - 4xxErrorProblem details with a stable
code: see Errors.
Example
curl "$SWINGBACK_API/members" \
-H "Authorization: Bearer $SWINGBACK_API_KEY"{
"data": [
{
"id": "mem_01h455vb4pex5vsknk084sn02q",
"account": {
"id": "acct_01h455vb4pex5vsknk084sn02q",
"avatar_url": null,
"email": "sam@acme.example.com",
"name": "Sam Lee"
},
"role": "owner",
"created_at": "2026-09-28T14:03:12.482Z"
}
],
"next_cursor": null,
"has_more": false
}The member object#
Fields
idstringStarts with
mem_accountobjectA team member's account. Its
idis what a changelog entry'sauthor_idstake.Child fields (4)
idstringStarts with
acct_avatar_urlstringnullableAt most 2,048 characters
emailstring · emailnamestringnullableAt most 100 characters
rolestringowneroradmin. Only owners manage owners and roles, the slug, the custom domain, billing and exports, and delete the workspace.One ofowneradmincreated_atstring · date-timeWhen the member joined the workspace.
Example
{
"id": "mem_01h455vb4pex5vsknk084sn02q",
"account": {
"id": "acct_01h455vb4pex5vsknk084sn02q",
"avatar_url": null,
"email": "sam@acme.example.com",
"name": "Sam Lee"
},
"role": "owner",
"created_at": "2026-09-28T14:03:12.482Z"
}