Add member to workspace

POST/workspaces/{workspace_id}/members

The user must be a member of the workspace's organization (422 not_org_member).

Path parameters

workspace_idstring

Workspace ID

Headers

Authorizationstring

Bearer <token>.

Body parameters

Member

created_atoptional string

deleted_atoptional string

idoptional string

joined_atoptional string

roleoptional string

ADMIN, MEMBER, DEVELOPER, VIEWER

statusoptional string

ACTIVE, INACTIVE, SUSPENDED

updated_atoptional string

user_idoptional string

workspace_idoptional string

Returns

201CreatedWorkspaceMember

created_atoptional string

deleted_atoptional string

idoptional string

joined_atoptional string

roleoptional string

ADMIN, MEMBER, DEVELOPER, VIEWER

statusoptional string

ACTIVE, INACTIVE, SUSPENDED

updated_atoptional string

user_idoptional string

workspace_idoptional string

Errors

400Bad Request
422Unprocessable Entity

curl --request POST \ --url 'https://api.hexelstudio.com/v1/workspaces/{workspace_id}/members' \ --header "Authorization: Bearer $ACCESS_TOKEN" \ --header 'Content-Type: application/json' \ --data '{ "created_at": "2026-01-01T00:00:00Z", "deleted_at": "2026-01-01T00:00:00Z", "id": "string", "joined_at": "2026-01-01T00:00:00Z", "role": "string", "status": "string", "updated_at": "2026-01-01T00:00:00Z", "user_id": "string", "workspace_id": "string" }'

const res = await fetch("https://api.hexelstudio.com/v1/workspaces/{workspace_id}/members", { method: "POST", headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "created_at": "2026-01-01T00:00:00Z", "deleted_at": "2026-01-01T00:00:00Z", "id": "string", "joined_at": "2026-01-01T00:00:00Z", "role": "string", "status": "string", "updated_at": "2026-01-01T00:00:00Z", "user_id": "string", "workspace_id": "string" }), }) const data = await res.json()

import os import requests res = requests.post( "https://api.hexelstudio.com/v1/workspaces/{workspace_id}/members", headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"}, json={ "created_at": "2026-01-01T00:00:00Z", "deleted_at": "2026-01-01T00:00:00Z", "id": "string", "joined_at": "2026-01-01T00:00:00Z", "role": "string", "status": "string", "updated_at": "2026-01-01T00:00:00Z", "user_id": "string", "workspace_id": "string", }, ) data = res.json()

{ "created_at": "2026-01-01T00:00:00Z", "deleted_at": "2026-01-01T00:00:00Z", "id": "string", "joined_at": "2026-01-01T00:00:00Z", "role": "string", "status": "string", "updated_at": "2026-01-01T00:00:00Z", "user_id": "string", "workspace_id": "string" }