> ## Documentation Index
> Fetch the complete documentation index at: https://chatobserver.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I compose and assess native reports through the API?

> Discover accessible native reports and assess exact saved revisions using measured, context-specific evidence.

Discover accessible native reports and assess exact saved revisions using measured, context-specific evidence.

Read [authentication](/docs/developers/authentication), [pagination and filters](/docs/developers/pagination-and-filters), and [safe writes and retries](/docs/developers/safe-writes) before integrating. Each endpoint below includes its request parameters, response schema, and code examples.

## Endpoints

* [Create a private native empty report draft](/docs/api-reference/reports/create-native-report-draft) — `POST /api/v2/reports`
* [Find accessible reports](/docs/api-reference/reports/get-canvas-reports) — `GET /api/v2/reports`
* [Read the exact report identity and assessment pages](/docs/api-reference/reports/get-canvas-report) — `GET /api/v2/reports/{reportId}`
* [Discover native assessment targets, contexts and profiles](/docs/api-reference/reports/get-canvas-capabilities) — `GET /api/v2/reports/canvas/capabilities`
* [Assess an exact saved report revision](/docs/api-reference/reports/post-canvas-assessment) — `POST /api/v2/reports/{reportId}/assessments`
* [Read assessment or composition progress](/docs/api-reference/reports/get-canvas-job) — `GET /api/v2/reports/canvas/jobs/{jobId}`
* [Cancel assessment or composition work](/docs/api-reference/reports/cancel-canvas-job) — `POST /api/v2/reports/canvas/jobs/{jobId}/cancel`
* [Read assessment readiness and pageable findings](/docs/api-reference/reports/get-canvas-assessment) — `GET /api/v2/reports/canvas/assessments/{assessmentId}`
* [Discover granular native configuration contracts](/docs/api-reference/reports/get-report-capability-index) — `GET /api/v2/reports/capabilities`
* [Read one versioned native configuration schema](/docs/api-reference/reports/get-report-capability-schema) — `GET /api/v2/reports/capabilities/{schemaId}`
* [Begin exact private native authoring](/docs/api-reference/reports/create-report-change-set) — `POST /api/v2/reports/{reportId}/change-sets`
* [Read confirmed private authoring receipts](/docs/api-reference/reports/read-report-change-set) — `GET /api/v2/reports/{reportId}/change-sets/{changeSetId}`
* [Discard uncommitted private authoring](/docs/api-reference/reports/discard-report-change-set) — `DELETE /api/v2/reports/{reportId}/change-sets/{changeSetId}`
* [Append typed native changes](/docs/api-reference/reports/append-report-changes) — `POST /api/v2/reports/{reportId}/change-sets/{changeSetId}/batches`
* [Validate and freeze the native stage](/docs/api-reference/reports/seal-report-change-set) — `POST /api/v2/reports/{reportId}/change-sets/{changeSetId}/seal`
* [Compose a sealed native change set](/docs/api-reference/reports/post-canvas-composition) — `POST /api/v2/reports/canvas/compositions`
* [Read measured plan and bounded placements/findings](/docs/api-reference/reports/get-canvas-plan) — `GET /api/v2/reports/canvas/plans/{planId}`
* [Install the exact measured native candidate atomically](/docs/api-reference/reports/commit-canvas-plan) — `POST /api/v2/reports/canvas/plans/{planId}/commit`
* [Read workspace branding, fonts and authoring guide](/docs/api-reference/reports/get-report-authoring-context) — `GET /api/v2/reports/authoring-context`
* [Compare private document and existing shared artifact identities](/docs/api-reference/reports/get-report-publication-state) — `GET /api/v2/reports/{reportId}/publication-state`
* [Read complete native page elements and optional surface provenance](/docs/api-reference/reports/get-native-report-page) — `GET /api/v2/reports/{reportId}/pages/{pageId}`
* [Read independently authorized source contracts without executing Data](/docs/api-reference/reports/get-native-report-data-sources) — `GET /api/v2/reports/{reportId}/data-sources`
* [Upload a report image](/docs/api-reference/reports/upload-report-image) — `POST /api/v2/reports/images`

[Download the complete OpenAPI specification](/docs/openapi.json) for client generation and schema validation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.