Semaphor

Update a tenant user

Updates a tenant user's name, email, role, active status, or department. Only include the fields you want to change — omitted fields are left unchanged. At least one field must be provided.

If you change the email, it must be unique within the user's tenant. Set isActive to false to deactivate a user without deleting them.

Requires an Admin role.

PUT
/api/management/v1/tenant-users/{tenantUserId}

Authorization

BearerAuth
AuthorizationBearer <token>

A project-scoped access token. Generate one via the Token API with your project ID and project secret.

In: header

Path Parameters

tenantUserId*string

The tenant user's ID (either auto-generated or a custom ID you provided at creation time).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X put "https://semaphor.cloud/api/management/v1/tenant-users/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "message": "string",
  "user": {
    "id": "string",
    "email": "user@example.com",
    "name": "string",
    "role": "VIEWER",
    "department": "string",
    "isActive": true,
    "tenantId": "string",
    "tenantName": "string",
    "organizationName": "string",
    "type": "tenant",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "details": "string",
  "code": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}