REST API
Read and write your governance records — AI use cases, risks, incidents, vendors, AI systems and more — from your own scripts and tools.
Set up by: An Admin or Owner
- Go to Settings › Admin Console › Integrations and find the API keys card.
- Give the key a name and choose its scope: read only, or read and write.
- Click Create key and copy it right away. It is shown once.
- Send it as a bearer token on every request. Each key may make 300 reads and 60 writes a minute. There are no delete calls.
- https://api.governbox.ai/api/v1
- Authorization: Bearer gbx_…
- https://api.governbox.ai/api/v1/machine-docs
Outbound webhooks
Get a signed HTTPS message in your own system the moment something changes: a use case is created, a risk is logged, an incident opens or closes, a document is approved, and more.
Set up by: An Admin or Owner
- Go to Settings › Admin Console › Integrations and find the Webhooks card.
- Enter your endpoint's address (it must start with https://) and a description.
- Tick the events you want. Leave them all unticked to receive every event.
- Click Add endpoint and copy the signing secret. It is shown once.
- Click Send test to send a ping. Failed deliveries are retried automatically.
- X-Governbox-Signature: t=<unix time>,v1=<hex>
- HMAC-SHA256 of "<t>.<raw body>" with your signing secret (the same scheme Stripe uses). Reject anything older than 5 minutes.
- X-Governbox-Delivery
Zapier, Jira, ServiceNow or any webhook
Let another system file an AI-tool request — a Jira ticket, a ServiceNow request, a form — straight into your Staff Reports queue, where an Admin approves or dismisses it.
Set up by: An Admin or Owner creates the key
- Create a read-and-write key under Settings › Admin Console › Integrations.
- In your tool, add a step that sends a POST to the intake address with the key. In Zapier, use Webhooks by Zapier › Custom Request.
- Set source to zapier, jira, servicenow, webhook, email or other, and send your own ticket number as the external reference. Sending the same one twice updates the request instead of duplicating it.
- Requests appear under Inventory › Staff Reports.
- POST https://api.governbox.ai/api/v1/intake/connector
Okta, Google Workspace, Microsoft Entra, Netskope, Zscaler, Cloudflare One
Upload the app list from your identity provider or CASB. The AI tools in it join your AI Discovery review queue, so shadow AI is found from the systems you already run.
Set up by: An Admin or Owner
- Export the app list from your platform. Okta: Reports › App Usage or the Applications export. Google Workspace: Admin console › Reports › Apps reports › Third-party app access › Download. Microsoft Entra: Enterprise applications › Usage & insights, or Defender for Cloud Apps › Discovered apps. Netskope, Zscaler and Cloudflare One: the Shadow IT or application discovery export.
- In GOVERNBOX.ai, go to Inventory › AI Discovery and open the Discovery+ import tab.
- Choose the platform and drop in the CSV or Excel file.
- To send it on a schedule instead, POST the rows (up to 5,000 at a time) with a read-and-write key.
- POST https://api.governbox.ai/api/v1/ai-discovery/imports/connector
OpenTelemetry (AI agent signals)
Point a second exporter at GOVERNBOX.ai and each AI agent's daily runs, tool calls, human overrides, guardrail trips and failures appear on its record. We keep the counts and store no spans.
Set up by: An Admin or Owner creates the key
- Create a read-and-write key under Settings › Admin Console › Integrations.
- Under Inventory › AI Agents, set each agent's External id to the agent id or name your traces carry.
- Add an OTLP/HTTP exporter (protobuf or JSON; gRPC is not accepted). In the OpenTelemetry Collector, use the otlphttp exporter.
- https://api.governbox.ai/api/v1/agents/signals/otlp
- Authorization: Bearer gbx_…
MCP server for your own AI agents
Give your own AI agents read access to your governance records, and on Pro let them file incidents, risks and intake requests into the same queues your people review.
Set up by: An Admin or Owner creates the key
- Create a key under Settings › Admin Console › Integrations: read only, or read and write.
- Add the address to any MCP client that supports Streamable HTTP with a bearer token.
- For a client that only runs local servers, use mcp-remote: npx mcp-remote <address> --header "Authorization: Bearer gbx_…"
- https://api.governbox.ai/api/v1/mcp
Zoom, Microsoft Teams and Google Meet transcripts
Bring a governance meeting's transcript or AI summary into the meeting's record. You upload the file; nothing connects to your meeting account.
Set up by: Anyone who can edit meetings
- Download the transcript from your meeting tool (.vtt, .txt or .docx), or copy its text.
- In GOVERNBOX.ai, go to Governance › Governance Meetings and open the meeting.
- Use Import meeting notes to upload the file or paste the text.