@@ -39905,6 +39905,64 @@ components:
3990539905 type: string
3990639906 x-enum-varnames:
3990739907 - INCIDENTS_GLOBAL_SETTINGS
39908+ GlobalOrg:
39909+ description: Organization information for a global organization association.
39910+ properties:
39911+ name:
39912+ description: The name of the organization.
39913+ example: Example Org
39914+ type: string
39915+ public_id:
39916+ description: The public identifier of the organization.
39917+ example: abcdef12345
39918+ nullable: true
39919+ type: string
39920+ subdomain:
39921+ description: The subdomain used to access the organization, if configured.
39922+ example: example
39923+ nullable: true
39924+ type: string
39925+ uuid:
39926+ description: The UUID of the organization.
39927+ example: "13d10a96-6ff2-49be-be7b-4f56ebb13335"
39928+ format: uuid
39929+ type: string
39930+ required:
39931+ - uuid
39932+ - name
39933+ type: object
39934+ GlobalOrgAttributes:
39935+ description: Attributes of an organization associated with the authenticated user.
39936+ properties:
39937+ org:
39938+ $ref: "#/components/schemas/GlobalOrg"
39939+ redirect_url:
39940+ description: The login URL used to switch into the organization, if available.
39941+ example: "https://app.datadoghq.com/account/login/password?dd_oid=13d10a96-6ff2-49be-be7b-4f56ebb13335&login_hint=user%40example.com"
39942+ nullable: true
39943+ type: string
39944+ source_region:
39945+ description: The source region of the organization.
39946+ example: us1.prod.dog
39947+ type: string
39948+ user:
39949+ $ref: "#/components/schemas/GlobalOrgUser"
39950+ required:
39951+ - user
39952+ - org
39953+ - source_region
39954+ type: object
39955+ GlobalOrgData:
39956+ description: An organization associated with the authenticated user.
39957+ properties:
39958+ attributes:
39959+ $ref: "#/components/schemas/GlobalOrgAttributes"
39960+ type:
39961+ $ref: "#/components/schemas/GlobalOrgType"
39962+ required:
39963+ - type
39964+ - attributes
39965+ type: object
3990839966 GlobalOrgIdentifier:
3990939967 description: A unique identifier for an organization including its site.
3991039968 properties:
@@ -39921,6 +39979,99 @@ components:
3992139979 - org_uuid
3992239980 - org_site
3992339981 type: object
39982+ GlobalOrgType:
39983+ description: The resource type for global user organizations.
39984+ enum: [global_user_orgs]
39985+ example: global_user_orgs
39986+ type: string
39987+ x-enum-varnames:
39988+ - GLOBAL_USER_ORGS
39989+ GlobalOrgUser:
39990+ description: User information for a global organization association.
39991+ properties:
39992+ handle:
39993+ description: The handle of the user.
39994+ example: user@example.com
39995+ type: string
39996+ uuid:
39997+ description: The UUID of the user.
39998+ example: "cfab5cf9-5472-48ea-a79c-a64045f4f745"
39999+ format: uuid
40000+ type: string
40001+ required:
40002+ - uuid
40003+ - handle
40004+ type: object
40005+ GlobalOrgsLinks:
40006+ description: Pagination links.
40007+ properties:
40008+ next:
40009+ description: Link to the next page.
40010+ example: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100&page[cursor]=next-page"
40011+ nullable: true
40012+ type: string
40013+ prev:
40014+ description: Link to the previous page.
40015+ nullable: true
40016+ type: string
40017+ self:
40018+ description: Link to the current page.
40019+ example: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100"
40020+ type: string
40021+ type: object
40022+ GlobalOrgsMeta:
40023+ description: Response metadata object.
40024+ properties:
40025+ page:
40026+ $ref: "#/components/schemas/GlobalOrgsMetaPage"
40027+ type: object
40028+ GlobalOrgsMetaPage:
40029+ description: Paging attributes.
40030+ properties:
40031+ cursor:
40032+ description: The cursor used to get the current results, if any.
40033+ example: ""
40034+ type: string
40035+ limit:
40036+ description: Number of results returned.
40037+ example: 100
40038+ format: int32
40039+ maximum: 1000
40040+ type: integer
40041+ next_cursor:
40042+ description: The cursor used to get the next results, if any.
40043+ example: next-page
40044+ nullable: true
40045+ type: string
40046+ prev_cursor:
40047+ description: The cursor used to get the previous results, if any.
40048+ nullable: true
40049+ type: string
40050+ type:
40051+ $ref: "#/components/schemas/GlobalOrgsMetaPageType"
40052+ type: object
40053+ GlobalOrgsMetaPageType:
40054+ description: Type of global orgs pagination.
40055+ enum: [cursor]
40056+ example: cursor
40057+ type: string
40058+ x-enum-varnames:
40059+ - CURSOR
40060+ GlobalOrgsResponse:
40061+ description: Response containing organizations across regions for the authenticated user.
40062+ properties:
40063+ data:
40064+ description: Organizations across regions for the authenticated user.
40065+ items:
40066+ $ref: "#/components/schemas/GlobalOrgData"
40067+ type: array
40068+ links:
40069+ $ref: "#/components/schemas/GlobalOrgsLinks"
40070+ meta:
40071+ $ref: "#/components/schemas/GlobalOrgsMeta"
40072+ required:
40073+ - data
40074+ type: object
3992440075 GlobalVariableData:
3992540076 description: Synthetics global variable data. Wrapper around the global variable object.
3992640077 properties:
@@ -128950,6 +129101,94 @@ paths:
128950129101 x-unstable: |-
128951129102 **Note**: This endpoint is in preview and is subject to change.
128952129103 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
129104+ /api/v2/global_orgs:
129105+ get:
129106+ description: |-
129107+ Returns organizations across regions for the authenticated user. The `user_handle` query parameter must match the authenticated user's handle.
129108+ operationId: ListGlobalOrgs
129109+ parameters:
129110+ - description: The handle of the authenticated user.
129111+ in: query
129112+ name: user_handle
129113+ required: true
129114+ schema:
129115+ example: user@example.com
129116+ type: string
129117+ - description: Maximum number of results returned.
129118+ in: query
129119+ name: page[limit]
129120+ required: false
129121+ schema:
129122+ default: 100
129123+ format: int32
129124+ maximum: 1000
129125+ minimum: 1
129126+ type: integer
129127+ - description: |-
129128+ String to query the next page of results.
129129+ This key is provided with each valid response from the API in `meta.page.next_cursor`.
129130+ in: query
129131+ name: page[cursor]
129132+ required: false
129133+ schema:
129134+ type: string
129135+ responses:
129136+ "200":
129137+ content:
129138+ application/json:
129139+ examples:
129140+ default:
129141+ value:
129142+ data:
129143+ - attributes:
129144+ org:
129145+ name: Example Org
129146+ public_id: abcdef12345
129147+ subdomain: example
129148+ uuid: "13d10a96-6ff2-49be-be7b-4f56ebb13335"
129149+ redirect_url: "https://app.datadoghq.com/account/login/password?dd_oid=13d10a96-6ff2-49be-be7b-4f56ebb13335&login_hint=user%40example.com"
129150+ source_region: us1.prod.dog
129151+ user:
129152+ handle: user@example.com
129153+ uuid: "cfab5cf9-5472-48ea-a79c-a64045f4f745"
129154+ type: global_user_orgs
129155+ links:
129156+ next: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100&page[cursor]=next-page"
129157+ self: "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100"
129158+ meta:
129159+ page:
129160+ cursor: ""
129161+ limit: 100
129162+ next_cursor: next-page
129163+ type: cursor
129164+ schema:
129165+ $ref: "#/components/schemas/GlobalOrgsResponse"
129166+ description: OK
129167+ "400":
129168+ $ref: "#/components/responses/BadRequestResponse"
129169+ "401":
129170+ $ref: "#/components/responses/UnauthorizedResponse"
129171+ "403":
129172+ $ref: "#/components/responses/ForbiddenResponse"
129173+ "429":
129174+ $ref: "#/components/responses/TooManyRequestsResponse"
129175+ security:
129176+ - apiKeyAuth: []
129177+ appKeyAuth: []
129178+ - AuthZ:
129179+ - user_access_read
129180+ summary: List global orgs
129181+ tags:
129182+ - Organizations
129183+ x-pagination:
129184+ cursorParam: page[cursor]
129185+ cursorPath: meta.page.next_cursor
129186+ limitParam: page[limit]
129187+ resultsPath: data
129188+ "x-permission":
129189+ operator: OR
129190+ permissions:
129191+ - user_access_read
128953129192 /api/v2/hamr:
128954129193 get:
128955129194 description: |-
0 commit comments