---
title: "Add a member to a workspace"
method: POST
path: "/v1/account/workspaces/{workspaceId}/members"
tags: ["WorkspaceAdminService", "Workspace Admin"]
---

# Add a member to a workspace

`POST /v1/account/workspaces/{workspaceId}/members`

Grants a profile access to the workspace by creating (or reactivating) the actor that links the profile to the workspace. Accepts either an existing profile_id or an email to resolve-or-invite. Idempotent for an already-active member. Admin only.

## Path parameters

- `workspaceId` string, required

## Request body

- AddWorkspaceMemberRequest — AddWorkspaceMemberRequest grants a profile access to a workspace. Provide exactly one of profile_id (an existing account profile) or email. When email is given, the backend resolves it to an existing account profile or invites a new one before linking it to the workspace via an actor.
  - `workspaceId` string — The workspace to add the member to (path).
  - `profileId` string — An existing account profile to add. Mutually exclusive with email.
  - `email` string — Email address to add (resolve-or-invite). Mutually exclusive with profile_id.

## Response `200`

OK

- WorkspaceMember — A member of a workspace: the profile granted access plus the actor row that links it to the workspace. Returned by member list/add operations.
  - `profileId` string, required — The account profile that has access to the workspace.
  - `actorId` string, required — The actor row linking the profile to the workspace (the junction record).
  - `name` string — Display name of the member's profile.
  - `email` string — Email address of the member's profile.
  - `addedAt` string, date-time — When the member was added to the workspace.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.net/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cadenya/cadenya-api/revisions/ac1a7f084068/schema)