Event Types - Case.dev

Case.dev exposes the following customer-facing events through webhook endpoints. This page is generated from the router event catalog and typed payload contracts so it stays aligned with the API.

Stable events keep their event name and payload shape frozen except for additive fields. Beta events may change during their early access window.

Generated from apps/router/server/utils/webhooks/catalog.ts.

Event	Stability	Scope	Resource	Description
`vault.upload.initiated`	stable	`vault`	`vault`	A vault object upload was initiated.
`vault.upload.completed`	stable	`vault`	`vault`	A vault object upload finished successfully.
`vault.upload.failed`	stable	`vault`	`vault`	A vault object upload failed.
`vault.object.append.started`	stable	`vault`	`vault`	Vault object append started.
`vault.object.append.completed`	stable	`vault`	`vault`	Vault object append finished successfully.
`vault.object.append.failed`	stable	`vault`	`vault`	Vault object append failed.
`vault.object.merge.started`	stable	`vault`	`vault`	Searchable vault object merge started.
`vault.object.merge.completed`	stable	`vault`	`vault`	Searchable vault object merge finished successfully.
`vault.object.merge.failed`	stable	`vault`	`vault`	Searchable vault object merge failed.
`vault.ingest.started`	stable	`vault`	`vault`	Vault object ingest started.
`vault.ingest.completed`	stable	`vault`	`vault`	Vault object ingest finished successfully.
`vault.ingest.failed`	stable	`vault`	`vault`	Vault object ingest failed.
`vault.ingest.page_count.retrieved`	stable	`vault`	`vault`	Vault object page count was derived during ingest.
`ocr.job.created`	stable	`vision_ocr`	-	An OCR job was enqueued.
`ocr.job.completed`	stable	`vision_ocr`	-	An OCR job finished successfully.
`ocr.job.failed`	stable	`vision_ocr`	-	An OCR job failed.
`voice.transcription.created`	stable	`transcription`	-	A transcription job was created.
`voice.transcription.reused`	stable	`transcription`	-	A completed transcription job was reused from cache.
`voice.transcription.audio_derivative.started`	stable	`transcription`	-	Audio derivative creation started for a large Vault video.
`voice.transcription.audio_derivative.completed`	stable	`transcription`	-	Audio derivative creation completed for a large Vault video.
`voice.transcription.audio_derivative.failed`	stable	`transcription`	-	Audio derivative creation failed for a large Vault video.
`voice.transcription.completed`	stable	`transcription`	-	A transcription job finished successfully.
`voice.transcription.failed`	stable	`transcription`	-	A transcription job failed.
`voice.transcription.deleted`	stable	`transcription`	-	A transcription job was deleted.
`linc.session.ended`	beta	`agent`	-	A native Linc session reached a terminal state (user_deleted, completed, failed, cancelled, runtime_crashed, timed_out).
`linc.session.turn.completed`	beta	`agent`	-	A native Linc session completed an assistant turn.
`matter.created`	beta	`legal`	`matter`	A matter was created.
`matter.updated`	beta	`legal`	`matter`	A matter was updated.
`work_item.execution.completed`	beta	`legal`	`matter`	A matter work item finished execution.
`work_item.execution.failed`	beta	`legal`	`matter`	A matter work item execution failed.
`billing.charge.succeeded`	stable	`webhooks`	-	A billing charge succeeded.
`billing.charge.failed`	stable	`webhooks`	-	A billing charge failed.
`balance.changed`	stable	`webhooks`	-	The organization credit balance changed.
`compute.run.completed`	stable	`compute`	-	A compute function run completed successfully.
`compute.run.failed`	stable	`compute`	-	A compute function run failed.
`deployment.succeeded`	stable	`webhooks`	-	A deployment succeeded.
`deployment.failed`	stable	`webhooks`	-	A deployment failed.
`webhook.endpoint.auto_disabled`	stable	`webhooks`	-	A webhook endpoint was automatically disabled after too many consecutive delivery failures. Subscribe to this to be notified when a downstream customer endpoint starts failing.
`connection.reauth_required`	beta	`connectors`	-	A connector connection lost provider authorization and needs reconnecting.
`connection.revoked`	beta	`connectors`	-	A connector connection was unlinked and its provider tokens revoked.
`link.orphaned`	beta	`connectors`	-	A connector link lost its provider folder, provider access, or vault.
`run.completed`	beta	`connectors`	-	A connector transfer run finished (possibly with per-file errors).
`run.failed`	beta	`connectors`	-	A connector transfer run failed before completing.
`link.objects_changed`	beta	`connectors`	-	A connector run changed the set of synced objects behind a link.

vault.upload.initiated

A vault object upload was initiated.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`filename`	`string`	Yes	Original filename provided by the uploader.
`mimeType`	`string`	No	MIME type of the uploaded file, if detected.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.upload.initiated",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "filename": "filename_value",
    "mimeType": "mimeType_value"
  }
}

vault.upload.completed

A vault object upload finished successfully.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`filename`	`string`	Yes	-
`mimeType`	`string`	Yes	-
`sizeBytes`	`number`	Yes	Size of the uploaded file in bytes.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.upload.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "filename": "filename_value",
    "mimeType": "mimeType_value",
    "sizeBytes": 42
  }
}

vault.upload.failed

A vault object upload failed.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`error`	`string`	Yes	Human-readable error description.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.upload.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "error": "Processing failed"
  }
}

vault.object.append.started

Vault object append started.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`appendObjectIds`	`string[]`	Yes	Vault object IDs whose pages will be appended onto the target object, in order.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.append.started",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "appendObjectIds": ["appendObjectId_123"]
  }
}

vault.object.append.completed

Vault object append finished successfully.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`appendObjectIds`	`string[]`	Yes	Vault object IDs whose pages will be appended onto the target object, in order.
`sizeBytes`	`number`	Yes	Size of the updated target object in bytes.
`pageCount`	`number`	Yes	Page count of the updated target object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.append.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "appendObjectIds": ["appendObjectId_123"],
    "sizeBytes": 42,
    "pageCount": 42
  }
}

vault.object.append.failed

Vault object append failed.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`appendObjectIds`	`string[]`	Yes	Vault object IDs whose pages will be appended onto the target object, in order.
`error`	`string`	Yes	Human-readable error description.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.append.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "appendObjectIds": ["appendObjectId_123"],
    "error": "Processing failed"
  }
}

vault.object.merge.started

Searchable vault object merge started.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`sourceObjectIds`	`string[]`	Yes	-
`clientReference`	`string`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.merge.started",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "sourceObjectIds": ["sourceObjectId_123"],
    "clientReference": "clientReference_value"
  }
}

vault.object.merge.completed

Searchable vault object merge finished successfully.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`sourceObjectIds`	`string[]`	Yes	-
`clientReference`	`string`	No	-
`sizeBytes`	`number`	Yes	-
`pageCount`	`number`	Yes	-
`filename`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.merge.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "sourceObjectIds": ["sourceObjectId_123"],
    "clientReference": "clientReference_value",
    "sizeBytes": 42,
    "pageCount": 42,
    "filename": "filename_value"
  }
}

vault.object.merge.failed

Searchable vault object merge failed.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`sourceObjectIds`	`string[]`	Yes	-
`clientReference`	`string`	No	-
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.object.merge.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "sourceObjectIds": ["sourceObjectId_123"],
    "clientReference": "clientReference_value",
    "error": "Processing failed"
  }
}

vault.ingest.started

Vault object ingest started.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`stage`	`string`	No	Pipeline stage that began (e.g. ‘extraction’, ‘chunking’).

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.ingest.started",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "stage": "stage_value"
  }
}

vault.ingest.completed

Vault object ingest finished successfully.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`durationMs`	`number`	Yes	Total ingest duration in milliseconds.
`chunkCount`	`number`	No	Number of chunks produced.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.ingest.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "durationMs": 1284,
    "chunkCount": 42
  }
}

vault.ingest.failed

Vault object ingest failed.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`error`	`string`	Yes	Human-readable error description.
`stage`	`string`	No	Pipeline stage that failed, if applicable.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.ingest.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "error": "Processing failed",
    "stage": "stage_value"
  }
}

vault.ingest.page_count.retrieved

Vault object page count was derived during ingest.

Property	Value
Stability	`stable`
Required scope	`vault`
Resource scope	`vault`

Payload

Field	Type	Required	Description
`vaultId`	`string`	Yes	The vault this event pertains to.
`objectId`	`string`	Yes	The object within the vault.
`filename`	`string`	Yes	Original filename for the vault object.
`mimeType`	`string`	No	MIME type of the vault object, if detected.
`pageCount`	`number`	Yes	Number of pages derived for this vault object.
`documentKind`	`string`	Yes	File classification used by the ingest pipeline (e.g. ‘pdf’, ‘docx’).
`source`	`string`	Yes	Extractor path that produced the page count.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "vault.ingest.page_count.retrieved",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "vaultId": "vault_123",
    "objectId": "object_123",
    "filename": "filename_value",
    "mimeType": "mimeType_value",
    "pageCount": 42,
    "documentKind": "documentKind_value",
    "source": "source_value"
  }
}

ocr.job.created

An OCR job was enqueued.

Property	Value
Stability	`stable`
Required scope	`vision_ocr`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	OCR job identifier.
`objectId`	`string`	Yes	The vault object being processed.
`vaultId`	`string`	Yes	-
`pageCount`	`number`	No	Number of pages queued for OCR.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "ocr.job.created",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "objectId": "object_123",
    "vaultId": "vault_123",
    "pageCount": 42
  }
}

ocr.job.completed

An OCR job finished successfully.

Property	Value
Stability	`stable`
Required scope	`vision_ocr`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	OCR job identifier.
`objectId`	`string`	Yes	The vault object being processed.
`vaultId`	`string`	Yes	-
`durationMs`	`number`	Yes	Processing duration in milliseconds.
`pageCount`	`number`	Yes	Number of pages processed.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "ocr.job.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "objectId": "object_123",
    "vaultId": "vault_123",
    "durationMs": 1284,
    "pageCount": 42
  }
}

ocr.job.failed

An OCR job failed.

Property	Value
Stability	`stable`
Required scope	`vision_ocr`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	OCR job identifier.
`objectId`	`string`	Yes	The vault object being processed.
`vaultId`	`string`	Yes	-
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "ocr.job.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "objectId": "object_123",
    "vaultId": "vault_123",
    "error": "Processing failed"
  }
}

voice.transcription.created

A transcription job was created.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	No	Vault that owns the source object, when the transcription came from a vault workflow.
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	No	Actual media object submitted to the speech provider.
`objectId`	`string`	No	Source vault object for vault-backed jobs.
`format`	`string`	No	Requested transcript output format.
`mode`	`'vault' \| 'direct'`	Yes	Transcription mode used by the request.
`status`	`string`	No	Provider status returned at job creation time.
`speakerLabels`	`boolean`	No	-
`autoHighlights`	`boolean`	No	-
`contentSafety`	`boolean`	No	-
`languageDetection`	`boolean`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.created",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "objectId": "object_123",
    "format": "format_value",
    "mode": "vault",
    "status": "active",
    "speakerLabels": true,
    "autoHighlights": true,
    "contentSafety": true,
    "languageDetection": true
  }
}

voice.transcription.reused

A completed transcription job was reused from cache.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	No	Vault that owns the source object, when the transcription came from a vault workflow.
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	No	Actual media object submitted to the speech provider.
`objectId`	`string`	Yes	-
`format`	`string`	No	-
`mode`	`'vault'`	Yes	-
`from_cache`	`true`	Yes	-
`options_hash`	`string`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.reused",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "objectId": "object_123",
    "format": "format_value",
    "mode": "vault",
    "from_cache": true,
    "options_hash": "options_hash_value"
  }
}

voice.transcription.audio_derivative.started

Audio derivative creation started for a large Vault video.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	Yes	-
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	Yes	-
`sourceObjectId`	`string`	Yes	-
`error`	`string`	No	-
`sourceDurationMs`	`number`	No	-
`sourceAudioDurationMs`	`number`	No	-
`sourceAudioStartMs`	`number`	No	-
`timelineOffsetMs`	`number`	No	-
`derivativeDurationMs`	`number`	No	-
`durationDriftMs`	`number`	No	-
`audioStreamIndex`	`number`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.audio_derivative.started",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "sourceObjectId": "sourceObject_123",
    "error": "Processing failed",
    "sourceDurationMs": 1284,
    "sourceAudioDurationMs": 1284,
    "sourceAudioStartMs": 1284,
    "timelineOffsetMs": 1284,
    "derivativeDurationMs": 1284,
    "durationDriftMs": 1284,
    "audioStreamIndex": 42
  }
}

voice.transcription.audio_derivative.completed

Audio derivative creation completed for a large Vault video.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	Yes	-
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	Yes	-
`sourceObjectId`	`string`	Yes	-
`error`	`string`	No	-
`sourceDurationMs`	`number`	No	-
`sourceAudioDurationMs`	`number`	No	-
`sourceAudioStartMs`	`number`	No	-
`timelineOffsetMs`	`number`	No	-
`derivativeDurationMs`	`number`	No	-
`durationDriftMs`	`number`	No	-
`audioStreamIndex`	`number`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.audio_derivative.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "sourceObjectId": "sourceObject_123",
    "error": "Processing failed",
    "sourceDurationMs": 1284,
    "sourceAudioDurationMs": 1284,
    "sourceAudioStartMs": 1284,
    "timelineOffsetMs": 1284,
    "derivativeDurationMs": 1284,
    "durationDriftMs": 1284,
    "audioStreamIndex": 42
  }
}

voice.transcription.audio_derivative.failed

Audio derivative creation failed for a large Vault video.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	Yes	-
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	Yes	-
`sourceObjectId`	`string`	Yes	-
`error`	`string`	No	-
`sourceDurationMs`	`number`	No	-
`sourceAudioDurationMs`	`number`	No	-
`sourceAudioStartMs`	`number`	No	-
`timelineOffsetMs`	`number`	No	-
`derivativeDurationMs`	`number`	No	-
`durationDriftMs`	`number`	No	-
`audioStreamIndex`	`number`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.audio_derivative.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "sourceObjectId": "sourceObject_123",
    "error": "Processing failed",
    "sourceDurationMs": 1284,
    "sourceAudioDurationMs": 1284,
    "sourceAudioStartMs": 1284,
    "timelineOffsetMs": 1284,
    "derivativeDurationMs": 1284,
    "durationDriftMs": 1284,
    "audioStreamIndex": 42
  }
}

voice.transcription.completed

A transcription job finished successfully.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	No	Vault that owns the source object, when the transcription came from a vault workflow.
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	No	Actual media object submitted to the speech provider.
`sourceObjectId`	`string`	Yes	-
`resultObjectId`	`string`	Yes	-
`audioDurationSeconds`	`number`	No	-
`wordCount`	`number`	Yes	-
`confidence`	`number`	No	-
`textLength`	`number`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "sourceObjectId": "sourceObject_123",
    "resultObjectId": "resultObject_123",
    "audioDurationSeconds": 42,
    "wordCount": 42,
    "confidence": 42,
    "textLength": 42
  }
}

voice.transcription.failed

A transcription job failed.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	No	Vault that owns the source object, when the transcription came from a vault workflow.
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	No	Actual media object submitted to the speech provider.
`sourceObjectId`	`string`	No	-
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "sourceObjectId": "sourceObject_123",
    "error": "Processing failed"
  }
}

voice.transcription.deleted

A transcription job was deleted.

Property	Value
Stability	`stable`
Required scope	`transcription`
Resource scope	None

Payload

Field	Type	Required	Description
`jobId`	`string`	Yes	-
`vaultId`	`string`	No	Vault that owns the source object, when the transcription came from a vault workflow.
`assemblyaiId`	`string`	No	AssemblyAI transcript identifier.
`inputObjectId`	`string`	No	Actual media object submitted to the speech provider.
`transcriptId`	`string`	Yes	-
`mode`	`'vault' \| 'direct'`	Yes	-
`providerDeleted`	`boolean`	Yes	-
`providerAlreadyDeleted`	`boolean`	Yes	-
`providerDeleteFailed`	`boolean`	Yes	-
`providerErrorStatusCode`	`number`	No	-
`inputObjectDeleted`	`boolean`	No	-
`resultObjectDeleted`	`boolean`	Yes	-
`localRecordDeleted`	`boolean`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "voice.transcription.deleted",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "jobId": "job_123",
    "vaultId": "vault_123",
    "assemblyaiId": "assemblyai_123",
    "inputObjectId": "inputObject_123",
    "transcriptId": "transcript_123",
    "mode": "vault",
    "providerDeleted": true,
    "providerAlreadyDeleted": true,
    "providerDeleteFailed": true,
    "providerErrorStatusCode": 42,
    "inputObjectDeleted": true,
    "resultObjectDeleted": true,
    "localRecordDeleted": true
  }
}

linc.session.ended

A native Linc session reached a terminal state (user_deleted, completed, failed, cancelled, runtime_crashed, timed_out).

Property	Value
Stability	`beta`
Required scope	`agent`
Resource scope	None

Payload

Field	Type	Required	Description
`sessionId`	`string`	Yes	-
`runtimeProvider`	`string`	Yes	-
`runtimeId`	`string \| null`	No	-
`model`	`string \| null`	No	-
`title`	`string \| null`	No	-
`organizationId`	`string \| null`	No	-
`terminalStatus`	`'done' \| 'failed' \| 'cancelled'`	No	-
`reason`	`LincSessionEndedReason`	Yes	-
`error`	`string \| null`	No	-
`endedAt`	`string`	Yes	-
`lastEventSeq`	`number`	Yes	-
`replayUrl`	`string \| null`	No	-
`resultMetadata`	`object \| null`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "linc.session.ended",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "sessionId": "session_123",
    "runtimeProvider": "runtimeProvider_value",
    "runtimeId": "runtime_123",
    "model": "model_value",
    "title": "title_value",
    "organizationId": "organization_123",
    "terminalStatus": "terminalStatus_value",
    "reason": "reason_value",
    "error": "Processing failed",
    "endedAt": "endedAt_value",
    "lastEventSeq": 42,
    "replayUrl": "replayUrl_value",
    "resultMetadata": {}
  }
}

linc.session.turn.completed

A native Linc session completed an assistant turn.

Property	Value
Stability	`beta`
Required scope	`agent`
Resource scope	None

Payload

Field	Type	Required	Description
`sessionId`	`string`	Yes	-
`runtimeProvider`	`string`	Yes	-
`runtimeId`	`string \| null`	No	-
`model`	`string \| null`	No	-
`title`	`string \| null`	No	-
`organizationId`	`string \| null`	No	-
`turnId`	`string`	Yes	-
`turnSeq`	`number`	Yes	-
`message`	`object`	Yes	-
`usage`	`unknown`	No	-
`finishReason`	`string \| null`	No	-
`completedAt`	`string`	Yes	-
`lastEventSeq`	`number`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "linc.session.turn.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "sessionId": "session_123",
    "runtimeProvider": "runtimeProvider_value",
    "runtimeId": "runtime_123",
    "model": "model_value",
    "title": "title_value",
    "organizationId": "organization_123",
    "turnId": "turn_123",
    "turnSeq": 42,
    "message": {},
    "usage": { "inputTokens": 123, "outputTokens": 456 },
    "finishReason": "finishReason_value",
    "completedAt": "completedAt_value",
    "lastEventSeq": 42
  }
}

matter.created

A matter was created.

Property	Value
Stability	`beta`
Required scope	`legal`
Resource scope	`matter`

Payload

Field	Type	Required	Description
`matterId`	`string`	Yes	-
`title`	`string`	No	Human-readable matter title.
`status`	`string`	Yes	Matter status at creation time.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "matter.created",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "matterId": "matter_123",
    "title": "title_value",
    "status": "active"
  }
}

matter.updated

A matter was updated.

Property	Value
Stability	`beta`
Required scope	`legal`
Resource scope	`matter`

Payload

Field	Type	Required	Description
`matterId`	`string`	Yes	-
`object`	`object`	Yes	Current state of the matter.
`previous_attributes`	`object`	No	Only-changed fields with their previous values. Present when the emitter supports change tracking.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "matter.updated",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "matterId": "matter_123",
    "object": {},
    "previous_attributes": {}
  }
}

work_item.execution.completed

A matter work item finished execution.

Property	Value
Stability	`beta`
Required scope	`legal`
Resource scope	`matter`

Payload

Field	Type	Required	Description
`matterId`	`string`	Yes	-
`workItemId`	`string`	Yes	-
`durationMs`	`number`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "work_item.execution.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "matterId": "matter_123",
    "workItemId": "workItem_123",
    "durationMs": 1284
  }
}

work_item.execution.failed

A matter work item execution failed.

Property	Value
Stability	`beta`
Required scope	`legal`
Resource scope	`matter`

Payload

Field	Type	Required	Description
`matterId`	`string`	Yes	-
`workItemId`	`string`	Yes	-
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "work_item.execution.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "matterId": "matter_123",
    "workItemId": "workItem_123",
    "error": "Processing failed"
  }
}

billing.charge.succeeded

A billing charge succeeded.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`chargeId`	`string`	Yes	Stripe charge or invoice ID.
`amountCents`	`number`	Yes	Amount in cents.
`currency`	`string`	Yes	ISO 4217 currency code.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "billing.charge.succeeded",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "chargeId": "charge_123",
    "amountCents": 2500,
    "currency": "usd"
  }
}

billing.charge.failed

A billing charge failed.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`chargeId`	`string`	Yes	-
`amountCents`	`number`	Yes	-
`currency`	`string`	Yes	-
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "billing.charge.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "chargeId": "charge_123",
    "amountCents": 2500,
    "currency": "usd",
    "error": "Processing failed"
  }
}

balance.changed

The organization credit balance changed.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`balanceCents`	`number`	Yes	New credit balance in cents.
`deltaCents`	`number`	Yes	Change amount (positive = credit added, negative = deducted).
`reason`	`string`	No	Reason for the change (e.g. ‘charge’, ‘top_up’, ‘promo’).

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "balance.changed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "balanceCents": 2500,
    "deltaCents": 2500,
    "reason": "reason_value"
  }
}

compute.run.completed

A compute function run completed successfully.

Property	Value
Stability	`stable`
Required scope	`compute`
Resource scope	None

Payload

Field	Type	Required	Description
`runId`	`string`	Yes	-
`functionId`	`string`	Yes	-
`durationMs`	`number`	Yes	-
`exitCode`	`number`	No	Exit code of the compute function.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "compute.run.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "runId": "run_123",
    "functionId": "function_123",
    "durationMs": 1284,
    "exitCode": 42
  }
}

compute.run.failed

A compute function run failed.

Property	Value
Stability	`stable`
Required scope	`compute`
Resource scope	None

Payload

Field	Type	Required	Description
`runId`	`string`	Yes	-
`functionId`	`string`	Yes	-
`error`	`string`	Yes	-
`exitCode`	`number`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "compute.run.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "runId": "run_123",
    "functionId": "function_123",
    "error": "Processing failed",
    "exitCode": 42
  }
}

deployment.succeeded

A deployment succeeded.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`deploymentId`	`string`	Yes	-
`appName`	`string`	No	Application or project name.
`url`	`string`	No	URL of the deployed application.
`durationMs`	`number`	No	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "deployment.succeeded",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "deploymentId": "deployment_123",
    "appName": "appName_value",
    "url": "url_value",
    "durationMs": 1284
  }
}

deployment.failed

A deployment failed.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`deploymentId`	`string`	Yes	-
`appName`	`string`	No	Application or project name.
`error`	`string`	Yes	-

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "deployment.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "deploymentId": "deployment_123",
    "appName": "appName_value",
    "error": "Processing failed"
  }
}

webhook.endpoint.auto_disabled

A webhook endpoint was automatically disabled after too many consecutive delivery failures. Subscribe to this to be notified when a downstream customer endpoint starts failing.

Property	Value
Stability	`stable`
Required scope	`webhooks`
Resource scope	None

Payload

Field	Type	Required	Description
`endpointId`	`string`	Yes	The endpoint that was disabled.
`url`	`string`	Yes	URL of the disabled endpoint.
`consecutiveFailures`	`number`	Yes	Number of consecutive failures that triggered the disable.
`lastFailureAt`	`string`	Yes	Timestamp of the last failed delivery attempt.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "webhook.endpoint.auto_disabled",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {
    "endpointId": "endpoint_123",
    "url": "url_value",
    "consecutiveFailures": 42,
    "lastFailureAt": "lastFailureAt_value"
  }
}

connection.reauth_required

A connector connection lost provider authorization and needs reconnecting.

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "connection.reauth_required",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

connection.revoked

A connector connection was unlinked and its provider tokens revoked.

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "connection.revoked",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

link.orphaned

A connector link lost its provider folder, provider access, or vault.

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "link.orphaned",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

run.completed

A connector transfer run finished (possibly with per-file errors).

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "run.completed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

run.failed

A connector transfer run failed before completing.

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "run.failed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

link.objects_changed

A connector run changed the set of synced objects behind a link.

Property	Value
Stability	`beta`
Required scope	`connectors`
Resource scope	None

Payload

Field	Type	Required	Description
(none)	-	-	Empty `data` object.

Example

{
  "id": "evt_01HV8ZK8M7Q9YJ6P5E3P2R1A0B",
  "type": "link.objects_changed",
  "occurred_at": "2026-04-24T15:12:09.481Z",
  "data": {}
}

​vault.upload.initiated

​Payload

​Example

​vault.upload.completed

​Payload

​Example

​vault.upload.failed

​Payload

​Example

​vault.object.append.started

​Payload

​Example

​vault.object.append.completed

​Payload

​Example

​vault.object.append.failed

​Payload

​Example

​vault.object.merge.started

​Payload

​Example

​vault.object.merge.completed

​Payload

​Example

​vault.object.merge.failed

​Payload

​Example

​vault.ingest.started

​Payload

​Example

​vault.ingest.completed

​Payload

​Example

​vault.ingest.failed

​Payload

​Example

​vault.ingest.page_count.retrieved

​Payload

​Example

​ocr.job.created

​Payload

​Example

​ocr.job.completed

​Payload

​Example

​ocr.job.failed

​Payload

​Example

​voice.transcription.created

​Payload

​Example

​voice.transcription.reused

​Payload

​Example

​voice.transcription.audio_derivative.started

​Payload

​Example

​voice.transcription.audio_derivative.completed

​Payload

​Example

​voice.transcription.audio_derivative.failed

​Payload

​Example

​voice.transcription.completed

​Payload

​Example

​voice.transcription.failed

​Payload

​Example

​voice.transcription.deleted

​Payload

​Example

​linc.session.ended

​Payload

​Example

​linc.session.turn.completed

​Payload

​Example

​matter.created

​Payload

vault.upload.initiated

Payload

Example

vault.upload.completed

Payload

Example

vault.upload.failed

Payload

Example

vault.object.append.started

Payload

Example

vault.object.append.completed

Payload

Example

vault.object.append.failed

Payload

Example

vault.object.merge.started

Payload

Example

vault.object.merge.completed

Payload

Example

vault.object.merge.failed

Payload

Example

vault.ingest.started

Payload

Example

vault.ingest.completed

Payload

Example

vault.ingest.failed

Payload

Example

vault.ingest.page_count.retrieved

Payload

Example

ocr.job.created

Payload

Example

ocr.job.completed

Payload

Example

ocr.job.failed

Payload

Example

voice.transcription.created

Payload

Example

voice.transcription.reused

Payload

Example

voice.transcription.audio_derivative.started

Payload

Example

voice.transcription.audio_derivative.completed

Payload

Example

voice.transcription.audio_derivative.failed

Payload

Example

voice.transcription.completed

Payload

Example

voice.transcription.failed

Payload

Example

voice.transcription.deleted

Payload

Example

linc.session.ended

Payload

Example

linc.session.turn.completed

Payload

Example

matter.created

Payload