session_finished (409)

View as Markdown Open in ChatGPT Open in Claude

`session_finished`

HTTP status: 409

Retryable: No — retrying without changes will fail the same way.

The session has finished and no further invite can be sent.

When it fires

A `POST /v1/sessions/{id}/resend` targeted a session that can no longer be re-invited: one that has completed, expired, or been cancelled, or is otherwise past the point where a fresh invite helps (for example already processing or awaiting review). Re-delivering the invite would email the applicant a link they can no longer act on.

How to handle it

Create a new session for the applicant and send the invite against the new session.

Example response

{
  "error": {
    "type": "https://docs.checktiv.com/api/errors/session_finished",
    "code": "session_finished",
    "message": "Session is 'completed': an invite cannot be sent for a finished session",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs.checktiv.com/api/errors/session_finished"
  }
}