Skip to main content

API Reference

Secutils.dev exposes a REST API for managing all resources programmatically. The full API is described by an OpenAPI 3.1 specification and can be explored interactively.

ResourceDescription
Interactive docssecutils.dev/api-docs
OpenAPI spec (JSON)secutils.dev/api-docs/openapi.json

Available API groups

TagBase pathDescription
webhooks/api/webhooks/respondersCreate HTTP responders that capture and replay incoming requests
certificates/api/certificates/templates, /api/certificates/private_keysGenerate X.509 certificate templates and manage private keys
web_scraping/api/web_scraping/page_trackers, /api/web_scraping/api_trackersTrack changes to web pages and API endpoints
web_security/api/web_security/cspBuild, parse, and serialize Content Security Policy headers
tags/api/user/tagsOrganize resources with colored tags
secrets/api/user/secretsStore encrypted secrets for use in scripts
scripts/api/user/scriptsManage reusable JavaScript scripts for responders and trackers
settings/api/user/settingsRead and update user preferences
data/api/user/dataExport and import user data

Authentication

All API endpoints require authentication via a session cookie (ory_kratos_session) or an API key passed as an Authorization header. Shared resources can be accessed anonymously with the x-secutils-share-id header.