Developer quickstart

Build your first SUNURA integration

Create one disclosure workflow from API key setup to notice generation, evidence capture, and export-ready records.

1. Create an API key

Create a server-side API key in the SUNURA dashboard. Keep the key in your backend or deployment secret store, not in browser JavaScript.

Use a separate key for test and production workspaces.
Rotate keys before broader customer testing.
Restrict access to developers who maintain the integration.

2. Classify the AI use case

Send the customer-facing AI use case to SUNURA so the disclosure workflow can be prepared consistently.

curl -X POST https://review.getsunura.com/api/v1/disclosures/classify \
  -H "x-sunura-api-key: $SUNURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"AI assistant","description":"Customer service chatbot","aiSystemType":"chatbot","jurisdiction":"EU"}'

3. Generate and install the notice

Generate the disclosure content and install it where the AI interaction is visible to the user.

Use server-side rendering where possible.
Keep the disclosure close to the AI interaction.
Preserve the generated disclosure version in your deployment metadata.

4. Capture evidence

Record when the notice was rendered, which version was shown, and which verification reference belongs to that event.

5. Export records

Export PDF, JSON, CSV, or ZIP evidence records for internal governance, customer review, or external assessment.

Next developer sections

Examples Webhooks CMS integrations API reference