Skip to content

Sandbox Management Menu

Eric Knee edited this page Jun 2, 2026 · 7 revisions

Options

# Option Description Dependencies
1 Reset Resets a sandbox, clearing ALL schemas, datasets, dataflows, identity configurations, segments, merge policies, and ingested profile data Valid environment file with sandbox access

Terminal output

Sandbox Management Menu


Prerequisites

Environment File

Field Description
API_KEY Client ID from your Developer Console project
CLIENT_SECRET Client Secret from your Developer Console project
IMS_ORG Your IMS Organization ID (must end with @AdobeOrg)
SANDBOX_NAME Target sandbox name
SCOPES Must include Experience Platform API scopes (e.g., openid, session, AdobeID, read_organizations, additional_info.projectedProductContext)

Platform Requirements

  • Administrative privileges for an IMS Org
  • Developer Console project with access to Adobe Experience Platform APIs
  • An Adobe Experience Platform role with Sandbox Management permissions for the target sandbox


Step 1: Reset Sandbox

Caution

Resetting a sandbox permanently deletes ALL data, schemas, datasets, dataflows, identity configurations, segments, merge policies, and ingested profile data. This action cannot be undone.

Wipes the sandbox and returns it to its original state. The CLI will prompt you to confirm the target sandbox name and then ask for explicit confirmation before proceeding.

Important

After reset, wait 60 minutes before CDP use or 120 minutes before AJO use.

Common Errors

Error Type Example Description Corrective Action
Access Token ✗ Failed to get access token: [error details] API credentials (API_KEY, CLIENT_SECRET, or SCOPES) are invalid or missing. Verify your environment file contains valid API_KEY, CLIENT_SECRET, and SCOPES values.
Sandbox Not Found ✗ Failed to reset sandbox my-sandbox: 404 The specified sandbox name does not exist. Verify the sandbox name matches an existing sandbox in your organization.
Insufficient Permissions ✗ Failed to reset sandbox my-sandbox: 403 Your API credentials do not have permission to reset sandboxes. Check in AEP Permissions that your API credential has Sandbox Management permissions.
Reset Failed ❌ Sandbox reset failed. Thats lame :( The Sandbox Management API returned an unexpected error. Retry the reset. If it persists, check the Platform status page or contact support.