Skip to main content

​
Session API and webhooks

  • Large deletions run as a job: when more than 20 sessions match a Batch Delete Sessions request, the API answers 202 with a deletion job and deletes them in the background. Poll Get Session Deletion Job until it reports COMPLETED or FAILED. Up to 20 sessions are still deleted in the request, with one result per session
  • Filtered select-all deletion: with delete_all: true you can narrow a deletion with the filters of List Sessions, each prefixed with filter_, for example filter_status or filter_date_from. An unknown filter or a value that cannot be read is refused before anything is deleted
  • Child verifications in deletion results: deleting a business verification also deletes the key-person and company verifications it created, and every deletion result reports how many in deleted_child_verifications
  • Fixed the deletion pages, which said queued webhooks still arrive after a session is deleted: webhook deliveries still queued for a deleted session, and their retries, are dropped. Webhooks already delivered are not affected
  • Fixed the Import Shared Session errors: an invalid, expired or foreign share token, or one for a session that was deleted, returns 400 with the reason under share_token