@@ -81529,55 +81529,57 @@ components:
8152981529 description: Attributes of user object returned by the API.
8153081530 properties:
8153181531 created_at:
81532- description: Creation time of the user.
81532+ description: The ISO 8601 timestamp of when the user account was created .
8153381533 format: date-time
8153481534 type: string
8153581535 disabled:
81536- description: Whether the user is disabled .
81536+ description: Whether the user account is deactivated. Disabled users cannot log in .
8153781537 type: boolean
8153881538 email:
81539- description: Email of the user.
81539+ description: The email address of the user, used for login and notifications .
8154081540 type: string
8154181541 handle:
81542- description: Handle of the user.
81542+ description: The unique handle (username) of the user, typically matching their email prefix .
8154381543 type: string
8154481544 icon:
81545- description: URL of the user's icon.
81545+ description: URL of the user's profile icon, typically a Gravatar URL derived from the email address .
8154681546 type: string
8154781547 last_login_time:
81548- description: The last time the user logged in.
81548+ description: The ISO 8601 timestamp of the user's most recent login, or null if the user has never logged in.
8154981549 format: date-time
8155081550 nullable: true
8155181551 readOnly: true
8155281552 type: string
8155381553 mfa_enabled:
81554- description: If user has MFA enabled.
81554+ description: Whether multi-factor authentication ( MFA) is enabled for the user's account .
8155581555 readOnly: true
8155681556 type: boolean
8155781557 modified_at:
81558- description: Time that the user was last modified.
81558+ description: The ISO 8601 timestamp of when the user account was last modified.
8155981559 format: date-time
8156081560 type: string
8156181561 name:
81562- description: Name of the user.
81562+ description: The full display name of the user as shown in the Datadog UI .
8156381563 nullable: true
8156481564 type: string
8156581565 service_account:
81566- description: Whether the user is a service account.
81566+ description: |-
81567+ Whether this is a service account rather than a human user.
81568+ Service accounts are used for programmatic API access.
8156781569 type: boolean
8156881570 status:
81569- description: Status of the user.
81571+ description: The current status of the user account (for example, `Active`, `Pending`, or `Disabled`) .
8157081572 type: string
8157181573 title:
81572- description: Title of the user.
81574+ description: The job title of the user (for example, "Senior Engineer" or "Product Manager") .
8157381575 nullable: true
8157481576 type: string
8157581577 uuid:
81576- description: UUID of the user.
81578+ description: The globally unique identifier ( UUID) of the user.
8157781579 readOnly: true
8157881580 type: string
8157981581 verified:
81580- description: Whether the user is verified.
81582+ description: Whether the user's email address has been verified.
8158181583 type: boolean
8158281584 type: object
8158381585 UserAttributesStatus:
@@ -81979,13 +81981,23 @@ components:
8197981981 description: Attributes of the edited user.
8198081982 properties:
8198181983 disabled:
81982- description: If the user is enabled or disabled.
81984+ description: |-
81985+ When set to `true`, the user is deactivated and can no longer log in.
81986+ When `false`, the user is active.
8198381987 type: boolean
8198481988 email:
81985- description: The email of the user.
81989+ description: |-
81990+ The email address of the user, used for login and notifications.
81991+ Must be a valid email format.
8198681992 type: string
8198781993 name:
81988- description: The name of the user.
81994+ description: |-
81995+ The full display name of the user as shown in the Datadog UI.
81996+ Maximum 55 characters, cannot contain `<` or `>`.
81997+ type: string
81998+ title:
81999+ description: The job title of the user (for example, "Senior Engineer" or "Product Manager").
82000+ nullable: true
8198982001 type: string
8199082002 type: object
8199182003 UserUpdateData:
@@ -96847,6 +96859,144 @@ paths:
9684796859 $ref: "#/components/responses/TooManyRequestsResponse"
9684896860 summary: Get all CSM Serverless Agents
9684996861 tags: ["CSM Agents"]
96862+ /api/v2/current_user:
96863+ get:
96864+ description: |-
96865+ Get the user associated with the current authentication context.
96866+ The response includes the user's profile attributes (name, email, handle,
96867+ status, MFA state), along with related resources: the user's organization,
96868+ assigned roles with their granted permissions, and team-scoped roles.
96869+ No additional permissions are required beyond valid authentication.
96870+ operationId: GetCurrentUser
96871+ responses:
96872+ "200":
96873+ content:
96874+ application/json:
96875+ examples:
96876+ default:
96877+ value:
96878+ data:
96879+ attributes:
96880+ created_at: "2024-01-15T10:30:00+00:00"
96881+ disabled: false
96882+ email: jane.doe@example.com
96883+ handle: jane.doe
96884+ icon: "https://secure.gravatar.com/avatar/abc123"
96885+ mfa_enabled: true
96886+ modified_at: "2024-06-01T12:00:00+00:00"
96887+ name: Jane Doe
96888+ service_account: false
96889+ status: Active
96890+ title: Senior Engineer
96891+ verified: true
96892+ id: 00000000-0000-9999-0000-000000000000
96893+ type: users
96894+ included: []
96895+ schema:
96896+ $ref: "#/components/schemas/UserResponse"
96897+ description: OK
96898+ "403":
96899+ content:
96900+ application/json:
96901+ schema:
96902+ $ref: "#/components/schemas/APIErrorResponse"
96903+ description: Authentication error
96904+ "429":
96905+ $ref: "#/components/responses/TooManyRequestsResponse"
96906+ security:
96907+ - apiKeyAuth: []
96908+ appKeyAuth: []
96909+ summary: Get current user
96910+ tags:
96911+ - Users
96912+ patch:
96913+ description: |-
96914+ Edit the profile of the currently authenticated user. Updatable fields
96915+ include `name`, `title`, `email`, and `disabled` status. The `id` field
96916+ in the request body must match the authenticated user's UUID; a mismatch
96917+ returns a 422 error. Email address changes are recorded in the audit trail.
96918+ Requires the `user_self_profile_write` permission.
96919+ operationId: UpdateCurrentUser
96920+ requestBody:
96921+ content:
96922+ application/json:
96923+ examples:
96924+ default:
96925+ value:
96926+ data:
96927+ attributes:
96928+ email: jane.doe@example.com
96929+ name: Jane Doe
96930+ title: Staff Engineer
96931+ id: 00000000-0000-9999-0000-000000000000
96932+ type: users
96933+ schema:
96934+ $ref: "#/components/schemas/UserUpdateRequest"
96935+ required: true
96936+ responses:
96937+ "200":
96938+ content:
96939+ application/json:
96940+ examples:
96941+ default:
96942+ value:
96943+ data:
96944+ attributes:
96945+ created_at: "2024-01-15T10:30:00+00:00"
96946+ disabled: false
96947+ email: jane.doe@example.com
96948+ handle: jane.doe
96949+ icon: "https://secure.gravatar.com/avatar/abc123"
96950+ mfa_enabled: true
96951+ modified_at: "2024-06-01T12:00:00+00:00"
96952+ name: Jane Doe
96953+ service_account: false
96954+ status: Active
96955+ title: Staff Engineer
96956+ verified: true
96957+ id: 00000000-0000-9999-0000-000000000000
96958+ type: users
96959+ included: []
96960+ schema:
96961+ $ref: "#/components/schemas/UserResponse"
96962+ description: OK
96963+ "400":
96964+ content:
96965+ application/json:
96966+ schema:
96967+ $ref: "#/components/schemas/APIErrorResponse"
96968+ description: Bad Request
96969+ "403":
96970+ content:
96971+ application/json:
96972+ schema:
96973+ $ref: "#/components/schemas/APIErrorResponse"
96974+ description: Authentication error
96975+ "404":
96976+ content:
96977+ application/json:
96978+ schema:
96979+ $ref: "#/components/schemas/APIErrorResponse"
96980+ description: Not found
96981+ "422":
96982+ content:
96983+ application/json:
96984+ schema:
96985+ $ref: "#/components/schemas/APIErrorResponse"
96986+ description: Unprocessable Entity
96987+ "429":
96988+ $ref: "#/components/responses/TooManyRequestsResponse"
96989+ security:
96990+ - apiKeyAuth: []
96991+ appKeyAuth: []
96992+ summary: Update current user
96993+ tags:
96994+ - Users
96995+ x-codegen-request-body-name: body
96996+ "x-permission":
96997+ operator: OR
96998+ permissions:
96999+ - user_self_profile_write
9685097000 /api/v2/current_user/application_keys:
9685197001 get:
9685297002 description: List all application keys available for current user
0 commit comments