Delete Session

View as Markdown
Permanently delete a closed flow session, purging its database record and all associated results or execution states. **Key Technical Details:** - **Irreversible**: Once deleted, the session and all its results are purged and cannot be recovered. - **Precondition (409 Conflict)**: The session must be closed/ended. If the session is still active, it will reject the request with `409 Conflict` (`session_not_closed`). You can check the current status using [Get Session State](api:GET/es-public-administration/v1/manager/{session_id}). - **Concurrency Lock (504)**: Acquires an exclusive database lock on the session. If the lock cannot be acquired within a reasonable time, it returns `504 Gateway Timeout`. > This endpoint needs to be executed with an app secret, so should always be used in server side without exposing the secret to customers.

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

session_idstringRequiredformat: "ObjectId"
Session ID to fetch

Response

204 No Content
Deleted Successfully

Errors

404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
504
Gateway Timeout Error