@@ -39935,6 +39935,64 @@ components:
3993539935 type: string
3993639936 x-enum-varnames:
3993739937 - INCIDENTS_GLOBAL_SETTINGS
39938+ GlobalOrg:
39939+ description: Organization information for a global organization association.
39940+ properties:
39941+ name:
39942+ description: The name of the organization.
39943+ example: Example Org
39944+ type: string
39945+ public_id:
39946+ description: The public identifier of the organization.
39947+ example: abcdef12345
39948+ nullable: true
39949+ type: string
39950+ subdomain:
39951+ description: The subdomain used to access the organization, if configured.
39952+ example: example
39953+ nullable: true
39954+ type: string
39955+ uuid:
39956+ description: The UUID of the organization.
39957+ example: "13d10a96-6ff2-49be-be7b-4f56ebb13335"
39958+ format: uuid
39959+ type: string
39960+ required:
39961+ - uuid
39962+ - name
39963+ type: object
39964+ GlobalOrgAttributes:
39965+ description: Attributes of an organization associated with the authenticated user.
39966+ properties:
39967+ org:
39968+ $ref: "#/components/schemas/GlobalOrg"
39969+ redirect_url:
39970+ description: The login URL used to switch into the organization, if available.
39971+ example: "https://app.datadoghq.com/account/login/password?dd_oid=13d10a96-6ff2-49be-be7b-4f56ebb13335&login_hint=user%40example.com"
39972+ nullable: true
39973+ type: string
39974+ source_region:
39975+ description: The source region of the organization.
39976+ example: us1.prod.dog
39977+ type: string
39978+ user:
39979+ $ref: "#/components/schemas/GlobalOrgUser"
39980+ required:
39981+ - user
39982+ - org
39983+ - source_region
39984+ type: object
39985+ GlobalOrgData:
39986+ description: An organization associated with the authenticated user.
39987+ properties:
39988+ attributes:
39989+ $ref: "#/components/schemas/GlobalOrgAttributes"
39990+ type:
39991+ $ref: "#/components/schemas/GlobalOrgType"
39992+ required:
39993+ - type
39994+ - attributes
39995+ type: object
3993839996 GlobalOrgIdentifier:
3993939997 description: A unique identifier for an organization including its site.
3994039998 properties:
@@ -39951,6 +40009,99 @@ components:
3995140009 - org_uuid
3995240010 - org_site
3995340011 type: object
40012+ GlobalOrgType:
40013+ description: The resource type for global user organizations.
40014+ enum: [global_user_orgs]
40015+ example: global_user_orgs
40016+ type: string
40017+ x-enum-varnames:
40018+ - GLOBAL_USER_ORGS
40019+ GlobalOrgUser:
40020+ description: User information for a global organization association.
40021+ properties:
40022+ handle:
40023+ description: The handle of the user.
40024+ example: user@example.com
40025+ type: string
40026+ uuid:
40027+ description: The UUID of the user.
40028+ example: "cfab5cf9-5472-48ea-a79c-a64045f4f745"
40029+ format: uuid
40030+ type: string
40031+ required:
40032+ - uuid
40033+ - handle
40034+ type: object
40035+ GlobalOrgsLinks:
40036+ description: Pagination links.
40037+ properties:
40038+ next:
40039+ description: Link to the next page.
40040+ example: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100&page[cursor]=next-page"
40041+ nullable: true
40042+ type: string
40043+ prev:
40044+ description: Link to the previous page.
40045+ nullable: true
40046+ type: string
40047+ self:
40048+ description: Link to the current page.
40049+ example: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100"
40050+ type: string
40051+ type: object
40052+ GlobalOrgsMeta:
40053+ description: Response metadata object.
40054+ properties:
40055+ page:
40056+ $ref: "#/components/schemas/GlobalOrgsMetaPage"
40057+ type: object
40058+ GlobalOrgsMetaPage:
40059+ description: Paging attributes.
40060+ properties:
40061+ cursor:
40062+ description: The cursor used to get the current results, if any.
40063+ example: ""
40064+ type: string
40065+ limit:
40066+ description: Number of results returned.
40067+ example: 100
40068+ format: int32
40069+ maximum: 1000
40070+ type: integer
40071+ next_cursor:
40072+ description: The cursor used to get the next results, if any.
40073+ example: next-page
40074+ nullable: true
40075+ type: string
40076+ prev_cursor:
40077+ description: The cursor used to get the previous results, if any.
40078+ nullable: true
40079+ type: string
40080+ type:
40081+ $ref: "#/components/schemas/GlobalOrgsMetaPageType"
40082+ type: object
40083+ GlobalOrgsMetaPageType:
40084+ description: Type of global orgs pagination.
40085+ enum: [cursor]
40086+ example: cursor
40087+ type: string
40088+ x-enum-varnames:
40089+ - CURSOR
40090+ GlobalOrgsResponse:
40091+ description: Response containing organizations across regions for the authenticated user.
40092+ properties:
40093+ data:
40094+ description: Organizations across regions for the authenticated user.
40095+ items:
40096+ $ref: "#/components/schemas/GlobalOrgData"
40097+ type: array
40098+ links:
40099+ $ref: "#/components/schemas/GlobalOrgsLinks"
40100+ meta:
40101+ $ref: "#/components/schemas/GlobalOrgsMeta"
40102+ required:
40103+ - data
40104+ type: object
3995440105 GlobalVariableData:
3995540106 description: Synthetics global variable data. Wrapper around the global variable object.
3995640107 properties:
@@ -129714,6 +129865,94 @@ paths:
129714129865 x-unstable: |-
129715129866 **Note**: This endpoint is in preview and is subject to change.
129716129867 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
129868+ /api/v2/global_orgs:
129869+ get:
129870+ description: |-
129871+ Returns organizations across regions for the authenticated user. The `user_handle` query parameter must match the authenticated user's handle.
129872+ operationId: ListGlobalOrgs
129873+ parameters:
129874+ - description: The handle of the authenticated user.
129875+ in: query
129876+ name: user_handle
129877+ required: true
129878+ schema:
129879+ example: user@example.com
129880+ type: string
129881+ - description: Maximum number of results returned.
129882+ in: query
129883+ name: page[limit]
129884+ required: false
129885+ schema:
129886+ default: 100
129887+ format: int32
129888+ maximum: 1000
129889+ minimum: 1
129890+ type: integer
129891+ - description: |-
129892+ String to query the next page of results.
129893+ This key is provided with each valid response from the API in `meta.page.next_cursor`.
129894+ in: query
129895+ name: page[cursor]
129896+ required: false
129897+ schema:
129898+ type: string
129899+ responses:
129900+ "200":
129901+ content:
129902+ application/json:
129903+ examples:
129904+ default:
129905+ value:
129906+ data:
129907+ - attributes:
129908+ org:
129909+ name: Example Org
129910+ public_id: abcdef12345
129911+ subdomain: example
129912+ uuid: "13d10a96-6ff2-49be-be7b-4f56ebb13335"
129913+ redirect_url: "https://app.datadoghq.com/account/login/password?dd_oid=13d10a96-6ff2-49be-be7b-4f56ebb13335&login_hint=user%40example.com"
129914+ source_region: us1.prod.dog
129915+ user:
129916+ handle: user@example.com
129917+ uuid: "cfab5cf9-5472-48ea-a79c-a64045f4f745"
129918+ type: global_user_orgs
129919+ links:
129920+ next: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100&page[cursor]=next-page"
129921+ self: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100"
129922+ meta:
129923+ page:
129924+ cursor: ""
129925+ limit: 100
129926+ next_cursor: next-page
129927+ type: cursor
129928+ schema:
129929+ $ref: "#/components/schemas/GlobalOrgsResponse"
129930+ description: OK
129931+ "400":
129932+ $ref: "#/components/responses/BadRequestResponse"
129933+ "401":
129934+ $ref: "#/components/responses/UnauthorizedResponse"
129935+ "403":
129936+ $ref: "#/components/responses/ForbiddenResponse"
129937+ "429":
129938+ $ref: "#/components/responses/TooManyRequestsResponse"
129939+ security:
129940+ - apiKeyAuth: []
129941+ appKeyAuth: []
129942+ - AuthZ:
129943+ - user_access_read
129944+ summary: List global orgs
129945+ tags:
129946+ - Organizations
129947+ x-pagination:
129948+ cursorParam: page[cursor]
129949+ cursorPath: meta.page.next_cursor
129950+ limitParam: page[limit]
129951+ resultsPath: data
129952+ "x-permission":
129953+ operator: OR
129954+ permissions:
129955+ - user_access_read
129717129956 /api/v2/hamr:
129718129957 get:
129719129958 description: |-
0 commit comments