Adobe Experience Cloud Sandboxes API

openapi: 3.2.0
info:
  title: Adobe Experience Cloud Adobe Experience Platform Sandboxes API
  description: The Adobe Experience Platform API provides RESTful access to the core services of Adobe Experience Platform, including data ingestion, unified profile management, identity resolution, dataset management, schema registry, query service, and segmentation. It enables developers to build and manage real-time customer profiles, ingest batch and streaming data, define XDM schemas, and orchestrate data workflows programmatically.
  version: 1.0.0
  contact:
    name: Adobe Developer
    url: https://developer.adobe.com/experience-platform-apis/
  license:
    name: Proprietary
    url: https://www.adobe.com/legal/terms.html
servers:
- url: https://platform.adobe.io
  description: Adobe Experience Platform Production API
security:
- bearerAuth: []
- apiKey: []
tags:
- name: Sandboxes
  description: Operations for managing platform sandboxes
paths:
  /data/foundation/sandbox-management/sandboxes:
    get:
      operationId: listSandboxes
      summary: Adobe Experience Platform Adobe Experience Cloud List Sandboxes
      description: Returns a list of all sandboxes available in the current IMS organization, including development and production sandboxes.
      tags:
      - Sandboxes
      parameters: []
      responses:
        '200':
          description: A list of sandboxes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SandboxList'
              examples:
                listSandboxes200Example:
                  summary: Default listSandboxes 200 response
                  x-microcks-default: true
                  value:
                    sandboxes:
                    - example
        '401':
          description: Authentication credentials are missing or invalid.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createSandbox
      summary: Adobe Experience Platform Adobe Experience Cloud Create a Sandbox
      description: Creates a new development sandbox within the IMS organization. Production sandboxes can only be created by system administrators.
      tags:
      - Sandboxes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - title
              - type
              properties:
                name:
                  type: string
                title:
                  type: string
                type:
                  type: string
                  enum:
                  - development
                  - production
            examples:
              createSandboxRequestExample:
                summary: Default createSandbox request
                x-microcks-default: true
                value:
                  name: Example Name
                  title: example
                  type: development
      responses:
        '201':
          description: Sandbox created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Sandbox'
              examples:
                createSandbox201Example:
                  summary: Default createSandbox 201 response
                  x-microcks-default: true
                  value:
                    name: Example Name
                    title: example
                    type: standard
                    state: example
                    region: example
        '400':
          description: Invalid sandbox configuration.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/foundation/sandbox-management/sandboxes/{sandboxName}:
    get:
      operationId: getSandbox
      summary: Adobe Experience Platform Adobe Experience Cloud Get a Sandbox
      description: Retrieves details for a single sandbox including its name, title, type, state, and region.
      tags:
      - Sandboxes
      parameters:
      - name: sandboxName
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Sandbox details returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Sandbox'
              examples:
                getSandbox200Example:
                  summary: Default getSandbox 200 response
                  x-microcks-default: true
                  value:
                    name: Example Name
                    title: example
                    type: standard
                    state: example
                    region: example
        '404':
          description: Sandbox not found.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteSandbox
      summary: Adobe Experience Platform Adobe Experience Cloud Delete a Sandbox
      description: Deletes a development sandbox and all its contained resources. Production sandboxes cannot be deleted, only reset.
      tags:
      - Sandboxes
      parameters:
      - name: sandboxName
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Sandbox deleted successfully.
        '404':
          description: Sandbox not found.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    SandboxList:
      type: object
      properties:
        sandboxes:
          type: array
          items:
            $ref: '#/components/schemas/Sandbox'
    Sandbox:
      type: object
      properties:
        name:
          type: string
        title:
          type: string
        type:
          type: string
        state:
          type: string
        region:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    apiKey:
      type: apiKey
      in: header
      name: x-api-key