Delete Session

Archive or permanently delete a signing session. By default the session is archived: its status becomes cancelled, reminders stop, still-active recipients are cancelled, and it can be restored from the sessions list in the AirSign app. With permanent=true the session is deleted: hidden everywhere and not restorable in the app. Deletion takes effect immediately on this endpoint; the AirSign MCP server adds a per-call confirmation step on top for AI assistants.

Endpoint

DELETE https://api.airsign.com.au/api/v1/Session/{sessionId} DELETE https://api.airsign.com.au/api/v1/Session/{sessionId}?permanent=true

Headers

Name	Value	Required	Description
Authorization	Bearer {access_token}	Yes	Bearer token with the `write:sessions` scope

Query Parameters

Name	Type	Required	Description
`permanent`	boolean	No	`false` (default) archives the session (restorable in the app); `true` deletes it permanently

Example Request

curl --location --request DELETE 'https://api.airsign.com.au/api/v1/Session/{uuid}' \
--header 'Authorization: Bearer {access_token}'

Response

Status: 200 OK

{
    "sessionId": "{uuid}",
    "name": "Junior Footy Registration - 2027 Season",
    "previousStatus": "draft",
    "status": "cancelled",
    "permanent": false,
    "restorable": true
}

Error Responses

Status	Description
`400`	Session is already archived (`ALREADY_ARCHIVED`) - pass `permanent=true` to delete it, or restore it in the app
`401`	Missing or invalid authentication token
`404`	Session not found (including already permanently deleted sessions)