@@ -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:
@@ -96714,6 +96726,144 @@ paths:
9671496726 $ref: "#/components/responses/TooManyRequestsResponse"
9671596727 summary: Get all CSM Serverless Agents
9671696728 tags: ["CSM Agents"]
96729+ /api/v2/current_user:
96730+ get:
96731+ description: |-
96732+ Get the user associated with the current authentication context.
96733+ The response includes the user's profile attributes (name, email, handle,
96734+ status, MFA state), along with related resources: the user's organization,
96735+ assigned roles with their granted permissions, and team-scoped roles.
96736+ No additional permissions are required beyond valid authentication.
96737+ operationId: GetCurrentUser
96738+ responses:
96739+ "200":
96740+ content:
96741+ application/json:
96742+ examples:
96743+ default:
96744+ value:
96745+ data:
96746+ attributes:
96747+ created_at: "2024-01-15T10:30:00+00:00"
96748+ disabled: false
96749+ email: jane.doe@example.com
96750+ handle: jane.doe
96751+ icon: "https://secure.gravatar.com/avatar/abc123"
96752+ mfa_enabled: true
96753+ modified_at: "2024-06-01T12:00:00+00:00"
96754+ name: Jane Doe
96755+ service_account: false
96756+ status: Active
96757+ title: Senior Engineer
96758+ verified: true
96759+ id: 00000000-0000-9999-0000-000000000000
96760+ type: users
96761+ included: []
96762+ schema:
96763+ $ref: "#/components/schemas/UserResponse"
96764+ description: OK
96765+ "403":
96766+ content:
96767+ application/json:
96768+ schema:
96769+ $ref: "#/components/schemas/APIErrorResponse"
96770+ description: Authentication error
96771+ "429":
96772+ $ref: "#/components/responses/TooManyRequestsResponse"
96773+ security:
96774+ - apiKeyAuth: []
96775+ appKeyAuth: []
96776+ summary: Get current user
96777+ tags:
96778+ - Users
96779+ patch:
96780+ description: |-
96781+ Edit the profile of the currently authenticated user. Updatable fields
96782+ include `name`, `title`, `email`, and `disabled` status. The `id` field
96783+ in the request body must match the authenticated user's UUID; a mismatch
96784+ returns a 422 error. Email address changes are recorded in the audit trail.
96785+ Requires the `user_access_manage` permission.
96786+ operationId: UpdateCurrentUser
96787+ requestBody:
96788+ content:
96789+ application/json:
96790+ examples:
96791+ default:
96792+ value:
96793+ data:
96794+ attributes:
96795+ email: jane.doe@example.com
96796+ name: Jane Doe
96797+ title: Staff Engineer
96798+ id: 00000000-0000-9999-0000-000000000000
96799+ type: users
96800+ schema:
96801+ $ref: "#/components/schemas/UserUpdateRequest"
96802+ required: true
96803+ responses:
96804+ "200":
96805+ content:
96806+ application/json:
96807+ examples:
96808+ default:
96809+ value:
96810+ data:
96811+ attributes:
96812+ created_at: "2024-01-15T10:30:00+00:00"
96813+ disabled: false
96814+ email: jane.doe@example.com
96815+ handle: jane.doe
96816+ icon: "https://secure.gravatar.com/avatar/abc123"
96817+ mfa_enabled: true
96818+ modified_at: "2024-06-01T12:00:00+00:00"
96819+ name: Jane Doe
96820+ service_account: false
96821+ status: Active
96822+ title: Staff Engineer
96823+ verified: true
96824+ id: 00000000-0000-9999-0000-000000000000
96825+ type: users
96826+ included: []
96827+ schema:
96828+ $ref: "#/components/schemas/UserResponse"
96829+ description: OK
96830+ "400":
96831+ content:
96832+ application/json:
96833+ schema:
96834+ $ref: "#/components/schemas/APIErrorResponse"
96835+ description: Bad Request
96836+ "403":
96837+ content:
96838+ application/json:
96839+ schema:
96840+ $ref: "#/components/schemas/APIErrorResponse"
96841+ description: Authentication error
96842+ "404":
96843+ content:
96844+ application/json:
96845+ schema:
96846+ $ref: "#/components/schemas/APIErrorResponse"
96847+ description: Not found
96848+ "422":
96849+ content:
96850+ application/json:
96851+ schema:
96852+ $ref: "#/components/schemas/APIErrorResponse"
96853+ description: Unprocessable Entity
96854+ "429":
96855+ $ref: "#/components/responses/TooManyRequestsResponse"
96856+ security:
96857+ - apiKeyAuth: []
96858+ appKeyAuth: []
96859+ summary: Update current user
96860+ tags:
96861+ - Users
96862+ x-codegen-request-body-name: body
96863+ "x-permission":
96864+ operator: OR
96865+ permissions:
96866+ - user_access_manage
9671796867 /api/v2/current_user/application_keys:
9671896868 get:
9671996869 description: List all application keys available for current user
0 commit comments