PUT Item (update)

Developing

PUT

/api/users/{user}

Update a user's profile: name (split into first_name/last_name), email, and role. The controller combines first_name + last_name into the name field before saving. Requires view users permission and same-org membership. Self-update is allowed.

Permission: view users (route-level permission:view users,api).

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api-dev.commandroom.ai/api/api/users/42' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "first_name": "Sample First Name",
  "last_name": "Sample Last Name",
  "email": "user@example.com",
  "role": "admin"
}'

Response Example

200 - OK

{
  "data": {
    "user_id": 1,
    "goteam_id": 1,
    "name": "Sample Name",
    "email": "user@example.com",
    "avatar_url": "https://example.com/sample",
    "email_verified_at": "2026-01-15T10:30:00.000000Z",
    "role": "string",
    "roles": [
      "string"
    ],
    "roles_display": "string",
    "status": "pending",
    "date_added": "string",
    "projects": [
      {}
    ],
    "assigned_tasks": [],
    "comments": [],
    "files": [],
    "uploads": [],
    "assigned_tasks_count": 10,
    "comments_count": 10,
    "files_count": 10,
    "uploads_count": 10,
    "created_at": "2026-01-15T10:30:00.000000Z",
    "updated_at": "2026-01-15T10:30:00.000000Z",
    "organizations": []
  }
}

Modified at 2026-07-02 04:47:16

GET Item (show)

POST Activate (activate)