Skip to main content
POST
Generate an evidence pack

Path Parameters

id
string<uuid>
required

Project id.

Body

application/json
kind
enum<string>
required

agent_card produces a Compliance Card for one agent (or all agents); control_evidence produces a framework-mapped document and requires framework.

Available options:
agent_card,
control_evidence
periodStart
string<date-time>
required
periodEnd
string<date-time>
required

Must be after periodStart; the period may not exceed 400 days.

framework
enum<string>

Required when kind is control_evidence; ignored otherwise.

Available options:
soc2
scope
object
format
enum<string>
default:html

No pdf value — this deployment has no headless-browser rendering path, so a PDF request is rejected here rather than silently downgraded to HTML.

Available options:
json,
html

Response

The pack row was created and generation was enqueued. The document itself is not ready yet — status is pending.

packId
string<uuid>
required
status
enum<string>
required

Always pending on this response — generation has just been enqueued.

Available options:
pending,
processing,
completed,
failed