compliance

Create evidence snapshot

Create an immutable export snapshot of selected compliance evidence.

If a snapshot with the same scope and content already exists, that snapshot is returned.

Required permission: compliance.export.

post/v1/projects/{project_id}/compliance/evidence-snapshots

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/compliance/evidence-snapshots
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

Request body

namestring required

Label for the snapshot.

system_idstring uuid nullable

AI system to capture. null captures every system, or those linked to environment_ids.

environment_idsstring[]

Limit telemetry to these environments. Each must be linked to a captured system.

time_fromstring date-time nullable

Start of the window for time-bound evidence such as incidents, transparency records and run telemetry.

time_tostring date-time nullable

End of the window for time-bound evidence. Must not precede time_from.

Response

Successful Response

idstring uuid required
project_idstring uuid required

Project the snapshot belongs to.

system_idstring uuid nullable required

AI system the snapshot was limited to. null when it covers several systems.

namestring required
scopeobject required

What was captured: system_ids, environment_ids, system_agent_environment_pairs, telemetry_scope, time_from and time_to.

content_hashstring required

SHA-256 hash of the canonical snapshot content, also sent as X-Content-SHA256 on download.

catalog_versionstring required

Version of the obligation catalog when the snapshot was taken.

created_bystring required

ID of the user who captured the snapshot.

created_atstring date-time required
coverageobject required

Coverage summary: control counts by status, transparency record counts, missing_items and missing_evidence, the time and environment scope, and the plan's data retention in days.

Changes

No recorded changes to this operation across all 2 revisions of this API.