Skip to main content

Delete App

Endpoint: Delete App

This endpoint allows users to delete an existing app on the RunGen.AI platform. The app is identified by its unique app_id. Once deleted, the app and its associated resources will no longer be accessible.

URL

DELETE https://api.rungen.ai/app/{app_id}

Path Parameters

ParameterTypeRequiredDescription
app_idStringYesThe unique identifier of the app to delete.

Headers

HeaderTypeRequiredDescription
x-api-keyStringYesYour API key for authentication.
x-team-idStringNoThe unique identifier for the team. If omitted, the app is retrieved based on the user's access.

Example Request

curl --location --request DELETE 'https://api.rungen.ai/app/745f7dc0-cd5a-488e-98ce-7d48c624060a' \
--header 'x-api-key: 123456789abc'

Response

Success

Status Code: 204 No Content

Response Body:
No content is returned for a successful delete operation.

Error

Status Code: 404 Not Found

Example Response Body:

{
"error": "App with ID '745f7dc0-cd5a-488e-98ce-7d48c624060a' not found."
}

Status Code: 403 Forbidden

Example Response Body:

{
"error": "Unauthorized access. Invalid API key."
}

Notes

  • Ensure the x-api-key header is valid and corresponds to the authenticated user or team.
  • The app must exist and be accessible to the user or team to be successfully deleted.
  • Deleting an app is irreversible, and all associated resources will be permanently removed.