PUT /api/user/v1/edit/

curl --request PUT \
  --url http://localhost:8000/api/user/v1/edit/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "first_name": "Ada",
    "last_name": "King",
    "middle_name": "Byron"
  }'

{
  "status": 1,
  "status_description": "user_profile_updated",
  "response_body": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "Byron",
      "last_name": "King",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T11:30:00.000000"
    }
  }
}

curl --request PUT \
  --url http://localhost:8000/api/user/v1/edit/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "first_name": "Ada",
    "last_name": "King",
    "middle_name": "Byron"
  }'

{
  "status": 1,
  "status_description": "user_profile_updated",
  "response_body": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "Byron",
      "last_name": "King",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T11:30:00.000000"
    }
  }
}

This endpoint updates the name fields on the authenticated user’s profile. Supply the new values in the JSON body; the response includes the full updated user object. To change the account password, use the companion endpoint PUT /api/user/v1/reset-password/update/ described below.

Both first_name and last_name are required even if you are only changing one field. Send the existing value for any field you do not wish to change.

Request

Method: PUT
URL: http://localhost:8000/api/user/v1/edit/
Authentication: X-OTAS-USER-TOKEN header

Headers

string

required

Signed JWT returned by /api/user/v1/login/ or /api/user/v1/create/.

Body parameters

string

required

Updated first name.

string

required

Updated last name.

string

Updated middle name. Pass an empty string to clear it.

Response

integer

required

1 on success, 0 on failure.

string

required

user_profile_updated on success.

object

Show properties

object

Show user properties

string

UUID of the user.

string

Updated first name.

string

Updated middle name.

string

Updated last name.

string

Email address (unchanged).

string

ISO 8601 timestamp of account creation.

string

ISO 8601 timestamp reflecting the time of this update.

Example

curl --request PUT \
  --url http://localhost:8000/api/user/v1/edit/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "first_name": "Ada",
    "last_name": "King",
    "middle_name": "Byron"
  }'

{
  "status": 1,
  "status_description": "user_profile_updated",
  "response_body": {
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "first_name": "Ada",
      "middle_name": "Byron",
      "last_name": "King",
      "email": "ada@example.com",
      "created_at": "2026-04-16T10:00:00.000000",
      "updated_at": "2026-04-16T11:30:00.000000"
    }
  }
}

Updating the password

To change the authenticated user’s password, send a PUT request to PUT /api/user/v1/reset-password/update/ with the same X-OTAS-USER-TOKEN header.

Body parameters

string

required

New password. Minimum 6 characters.

On success the server returns { "status": 1, "status_description": "password_updated", "response_body": null }.

Error responses

`status_description`	HTTP status	Cause
`missing_token`	400	The `X-OTAS-USER-TOKEN` header was absent.
`invalid_token`	401	The token is malformed, expired, or not associated with a user.
`missing_required_fields`	400	`first_name` or `last_name` was empty or missing from the body.
`password_too_short`	400	Password supplied to the password-update endpoint is fewer than 6 characters.

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

PUT /api/user/v1/edit/

Request

Headers

Body parameters

Response

Example

Updating the password

Body parameters

Error responses

​Request

​Headers

​Body parameters

​Response

​Example

​Updating the password

​Body parameters

​Error responses

Request

Headers

Body parameters

Response

Example

Updating the password

Body parameters

Error responses