Infisical: API Design — Secrets & Machine Identities
Docs-backedREST API at app.infisical.com/api (cloud) or self-hosted URL. Secret operations: GET /api/v3/secrets/raw with workspaceId, environment, and secretPath returns decrypted secrets. Create: POST /api/v3/secrets/raw/{secretName}. Update: PATCH. Delete: DELETE. The API uses workspace and environment scoping — workspaces map to projects, environments map to deployment stages. Folder structure enables hierarchical secret organization. Secret versioning with rollback support. Secret imports enable cross-environment/cross-project referencing. Dynamic secrets (growing feature set) generate on-demand credentials for databases. The API is clean and REST-idiomatic. Webhooks notify on secret changes. Audit logs track all operations. The API design prioritizes simplicity while covering the full secrets lifecycle.