---
title: "Update Team Users"
method: PATCH
path: "/api/v2/TeamUsers/{id}"
tags: ["TeamUsers"]
---

# Update Team Users

`PATCH /api/v2/TeamUsers/{id}`

Update an existing standard or service user by providing new values for the user properties to update using the following endpoint: 

 > `PATCH /api/v2/TeamUsers/{userGuid}` 

 Replace `{userGuid}` with the `userGuid` value of the user you want to update. You can get the `userGuid` for a user in the response to the "List All Team Users" endpoint. 

 Here is an example `body` payload for a standard user:

  > `{"name": "new_name",  "userEnabled": 0}` 

 Here is an example `body` payload for a service user:

  > `{"name": "new_name",  "userEnabled": 0, "description": "new_description"}`

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- union
  - TeamUsersStandardUserUpdateSchema
    - `type` 'StandardUser' — The user type. This type cannot be changed after the user is created.
    - `name` string — A name for the standard user.
    - `userEnabled` 0 | 1 — When sending a request, use this attribute to enable or disable a team user's access. When included in a response, returns `1` for enabled team users, or returns `0` for disabled team users. NOTE: This will eventually change to being `true`/`false`.
  - TeamUsersServiceUserUpdateSchema
    - `type` 'ServiceUser' — The user type. This type cannot be changed after the user is created.
    - `name` string — A name for the service user.
    - `description` string — The description for the service user.
    - `userEnabled` 0 | 1 — When sending a request, use this attribute to enable or disable a team user's access. When included in a response, returns `1` for enabled team users, or returns `0` for disabled team users. NOTE: This will eventually change to being `true`/`false`

## Response `200`

No Error

- object
  - `data` union
    - TeamUsersStandardUserResponseSchema
      - `type` 'StandardUser', required — The user type. This type cannot be changed after the user is created.
      - `name` string, required — A name for the standard user.
      - `userEnabled` 0 | 1 — When sending a request, use this attribute to enable or disable a team user's access. When included in a response, returns `1` for enabled team users, or returns `0` for disabled team users. NOTE: This will eventually change to being `true`/`false`.
      - `company` string, required — The name of the business or organization associated with the user.
      - `email` string, required — The user's email address.
      - `userGuid` string — A unique ID for the standard user. Use this value to get details for a user or to update or delete a user's account.
      - `lastLoginTime` number — When the user last logged in to the FortiCNAPP Console.
      - `orgAccess` 'NO_ORG_ACCESS' — This field shows if the user has no org, org admin or org user access
    - TeamUsersServiceUserResponseSchema
      - `type` 'ServiceUser', required — The user type. This type cannot be changed after the user is created.
      - `name` string, required — A name for the service user.
      - `description` string — The description for the service user.
      - `userEnabled` 0 | 1 — When sending a request, use this attribute to enable or disable a team user's access. When included in a response, returns `1` for enabled team users, or returns `0` for disabled team users. NOTE: This will eventually change to being `true`/`false`
      - `userGuid` string — A unique ID for the service user. Use this value to get details for a user or to update or delete a user's account.
      - `serviceUserId` string — The unique displayable identifier for a service user, similar to the email address for a standard user.
      - `apiKeys` object[]
        - `createdDate` string
        - `keyId` string
        - `createdUser` string
        - `status` string
      - `lastLoginTime` number — When the user last logged in to the FortiCNAPP Console.
      - `orgAccess` 'NO_ORG_ACCESS' — This field shows if the user has no org, org admin or org user access

## Other responses

- `4XX` — Client Error
- `5XX` — Internal Server Error

---

[API](https://skmtc.net/lacework/apis/forticnapp-api-2-0-documentation.md) · [All operations](https://skmtc.net/lacework/apis/forticnapp-api-2-0-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lacework/forticnapp-api-2-0-documentation/versions/7015f76895f2/schema)