DELETE /organizations

Deletes a sub-account (child organization) owned by the authenticated parent account. This permanently removes the sub-account, its users, and its Stripe billing subscription.

📘

Interested in SubAccounts?

SubAccounts is part of a specific plan. If you'd like to join this plan or learn more about the feature, get in touch with Panda Video support through your dashboard: https://dashboard.pandavideo.com.br/#/videos.

📘

Authorization

Only parent accounts can delete their own sub-accounts. The target organization_id must be a sub-account whose parent_organization_id equals the authenticated parent organization.

🚧

The sub-account must be in error status

A sub-account can only be deleted when its status is error. Deleting an active, inactive, or blocked sub-account fails with 400 "Subaccount must be in error status to be deleted." (To take a running sub-account out of service, set its status via Update SubAccount first.)

HTTP Method & Path

DELETE /organizations?action=delete-sub-account

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

• Security Scheme: PandaAuth (apiKey)
• Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Query Parameters

Request Body

Content-Type: application/json

Example Request Body

{
  "organization_id": "efcb5915-df17-46b6-bfd8-e8998bc94917"
}

Response

Success Response (200)

{
  "status": "deleted",
  "organization_id": "efcb5915-df17-46b6-bfd8-e8998bc94917"
}

Response Schema

⚠️

Irreversible side effects: deleting a sub-account cancels its Stripe customer and subscriptions and destroys all users of the sub-account organization before removing the organization itself. This cannot be undone.

Error Responses

• 400 Bad Request — one of:
  • Validation error (missing/invalid organization_id).
  • "Organization is not a sub-account." — the target has no parent organization.
  • "You do not have permission to delete this sub-account." — the target is not owned by your organization.
  • "Subaccount must be in error status to be deleted." — the sub-account is not in error status.
• 401 Unauthorized — Invalid or missing API token.
• 500 Internal Server Error — server error (also returned when the organization_id does not exist).

Example Usage

cURL

curl -X DELETE \
  'https://api-v2.pandavideo.com.br/organizations?action=delete-sub-account' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_id": "efcb5915-df17-46b6-bfd8-e8998bc94917"
}'