1. Members
Enspace
  • Introduction
  • Authentication
  • Concepts
  • First Steps
  • Workspaces
    • Types
      • Fields
        • List Fields
        • Create Field
        • Get Field
        • Field Updated
        • Delete Field
      • Items
        • List Items
        • Create Item
        • Count Items
        • Get Item
        • Update Item
        • Delete item
      • Flows
        • Stages
          • Tasks
            • List Tasks
            • Get specific Task
            • New Task
          • List Stages
          • Get specific Stage
        • List Flows
        • Get specific Flow
      • Forms
        • List Form
        • Get specific Form
        • List Form Create
      • List Types
      • Count Types
      • Get specific Type
      • Create Type
      • Update Type
      • Delete Type
    • Members
      • List Members
        GET
      • Count Members
        GET
      • Get Member
        GET
      • New Member
        POST
      • Update Member
        PUT
      • Remove Member
        DELETE
    • Roles
      • List roles
      • Create role
      • Count roles
      • Get specific role
      • Update role
      • Delete role
      • List Role Permissions
      • Add Permission to Role
      • Remove Role Permission
    • Member Groups
      • List groups
      • New group
      • Get group
      • Update group
      • Delete group
      • Add Users
      • Remove Users
    • Quick Tasks
      • List Quick Tasks
      • Count Quick Tasks
      • Get Quick Task
      • Delete Quick Task
      • Update Quick Task
      • New Quick Task
    • Integrations
      • CertiSign
      • Docusign
      • D4Sign
      • Clicksign
      • Adobe Sign
      • Whatsapp Twilio
      • SendGrid
      • OpenAi
      • Integration
      • New Integration
    • Schedule Tasks
      • List Schedule Tasks
      • Get specify Schedule Task
    • List Workspaces
      GET
    • Workspace Context
      GET
    • New Workspace
      POST
    • Leave the workspace
      POST
    • Workspace Statistics
      GET
    • Workspace Deletion Preview
      GET
    • Delete Workspace
      DELETE
  • User
    • Request Log
      GET
    • List API Keys
      GET
  • Schemas
    • Schemas
      • Members
        • MemberUpdate
        • MemberCreate
        • Member
      • Roles
        • Role
        • RoleCreate
        • RoleUpdate
      • MemberGroups
        • MemberGroup
        • MemberGroupCreate
        • MemberGroupUpdate
      • Types
        • Type
        • TypeInput
        • TypeDetail
      • Items
        • Item
        • ItemInput
      • Workspace
        • WorkspaceContext
        • WorkspaceStats
        • Workspace
        • WorkspaceCreate
        • WorkspaceUpdate
      • Tasks
        • Tasks
      • Flow
        • Flow
      • Stages
        • Stage
      • Forms
        • Forms
      • Integrations
        • Integrations
      • User
      • RequestLog
      • UserApiKey
      • SuccessResponse
      • ErrorResponse
      • Field
      • FieldInput
      • Permission
      • PermissionInput
    • Response
      • BadRequest
      • Unauthorized
      • Forbidden
      • NotFound
      • ServerError
    • Position
    • Dimensions
    • NodeType
    • WorkflowNodeDefinition
    • WorkflowEdgeDefinition
    • TaskFields
    • TriggerNodeData
    • CronConfig
    • StartNodeData
    • EndNodeData
    • ApprovalNodeData
    • TaskNodeData
    • FormNodeData
    • EmailNodeData
    • ConditionalsNodeData
    • ConditionalRule
    • ConditionalsNodeData_examples_inline
    • RouteNodeData
    • RouteRule
    • MergeNodeData
    • CrudNodeData
    • HttpNodeData
    • Error
    • AiNodeData
    • ComparisonNotificationNodeData
    • Workflow
    • WorkflowCreate
    • WorkflowUpdate
    • WorkflowExecution
    • NodeExecution
  1. Members

Update Member

Developing
Develop Env
https://api-develop.enspace.io
Develop Env
https://api-develop.enspace.io
PUT
https://api-develop.enspace.io
/ws/members/{memberId}
Maintainer:Not configured

Update Member#

Updates the information of an existing member in the workspace.

Parameters#

memberId (path) - ID of the member-workspace link

Request Body#

FieldTypeRequiredDescription
typestringNoNew member type
rolenumberNoNew role ID
statusstringNoNew status (active, inactive, blocked)

Member Type Update Rules#

From → ToAllowedNotes
owner → any❌Owner cannot change type
any → owner❌Use specific transfer endpoint
full ↔ standard✅-
viewer → full/standard✅-
full/standard → viewer✅-

v1 Compatibility Mode#

When v1_compatibility=true:
❌ Changing to owner or viewer types is not allowed
❌ Updating members of type owner or viewer is not allowed
🔓 full type ignores the role field

Request Example#

{
  "type": "standard",
  "role": 5
}

Response#

Returns the updated member object.

Notes#

Only the fields sent will be updated
Changing status to inactive removes access but keeps the link
Permissions are recalculated immediately after update

Error Codes#

400 - Invalid type or not allowed in v1 mode
403 - No permission or attempt to change owner
422 - Invalid role/groups for the new type

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
API Key
Add parameter in header
en-workspace
Example:
en-workspace: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Member updated
Body

🟠400Invalid request
🟠401Unauthorized
🟠403Forbidden
🟠404Record not found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api-develop.enspace.io/ws/members/' \
--header 'x-api-key: <api-key>' \
--header 'en-workspace: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "full",
    "status": "active",
    "role": 0
}'
Response Response Example
200 - Example 1
{
    "id": 0,
    "created_at": "string",
    "updated_at": "string",
    "user": {
        "id": 0,
        "created_at": "string",
        "email": "string",
        "meta": {
            "fname": "string",
            "lname": "string"
        }
    },
    "email": "string",
    "type": "owner",
    "role": 0,
    "status": "active"
}
Previous
New Member
Next
Remove Member
Built with