Supporting infrastructure
Infrastructure Documentation
SwiftAPI Authority is the cryptographic infrastructure developed by SwiftAPI Labs to issue, verify, revoke, and audit execution attestations. It supports the laboratory's research and enterprise integration work.
System overview
Attestation before execution.
AI agent or model route
|
v
SwiftAPI Authority
issues a signed attestation
|
v
Mandatory enforcement point
proxy, gateway, admission controller, or runtime hook
|
v
Execution allowed or deniedSwiftAPI Authority does not execute actions and does not run agents. It issues verifiable permission artifacts that external enforcement points check before allowing execution.
No attestation, no execution.
Python SDK
The enforcement loop.
Install
pip install swiftapi-pythonGuard an action
from swiftapi import SwiftAPI, Enforcement
api = SwiftAPI(key="swiftapi_live_...")
guard = Enforcement(api)
guard.run(
func=destructive_action,
action="database_drop",
intent="Schema cleanup script",
)- Local Ed25519 signature verification.
- Real-time revocation checks and replay defense.
- Fail-closed behavior when verification cannot be completed.
Provider wrappers
Attested inference without surrendering provider credentials.
OpenAI-compatible wrapper
from swiftapi import OpenAI
client = OpenAI(
swiftapi_key="swiftapi_live_...",
openai_key="sk-...",
)
response = client.chat.completions.create(
model="gpt-5.2",
messages=[{"role": "user", "content": "Hello"}],
)Anthropic-compatible wrapper
from swiftapi import Anthropic
client = Anthropic(
swiftapi_key="swiftapi_live_...",
anthropic_key="sk-ant-...",
)The SDK obtains an attestation from SwiftAPI Authority, then calls the selected provider with the customer's provider key. Provider keys are not sent to SwiftAPI Authority.
Authority model
Keys, scopes, and governance.
| Key type | Purpose |
|---|---|
Recovery | Emergency root authority. Offline storage recommended. |
Owner | Manages authority, policies, grants, and regular keys. |
Regular | Scoped authority for systems, automation, and delegated access. |
| Scope | Capability |
|---|---|
verify | Issue and revoke execution attestations. |
grants | Create and revoke delegated authority. |
policy | Propose, approve, and activate policy bundles. |
admin | Manage authority keys and access-denial records. |
Attestations
Signed, scoped, expiring execution records.
| Signing algorithm | Ed25519 |
|---|---|
| Token form | Canonical payload with a detached signature in the attestation record |
| Default TTL | 48 hours, subject to authority configuration |
| Replay defense | Unique JTI per attestation |
| Revocation | Pull-based through /attestation/revocations |
API surfaces
Website routes and authority routes are separate.
getswiftapi.com website APIs
These routes support the public research site, enterprise intake, and hidden legacy operations.
| Endpoint | Method | Description |
|---|---|---|
/api/void-test | GET, POST | Describe or run the live five-model VOID benchmark |
/api/challenge | GET, POST | Redacted sandbox feed or exploratory model execution |
/api/execute | GET, POST | Legacy execution-demonstration interface |
/api/waitlist | POST | Enterprise evaluation intake using the existing storage flow |
/api/status | GET | Hidden legacy authority-request status lookup |
/api/request | POST | Administrative issuance only; requires an issuance token |
/api/retrieve | POST | Hidden one-time key retrieval |
swiftapi.ai public authority APIs
| Endpoint | Method | Description |
|---|---|---|
/ | GET | Authority metadata and public key |
/health | GET | Authority health check |
/attestation/info | GET | Attestation format, public key, and TTL information |
/attestation/verify | POST | Verify an attestation, rate limited |
/attestation/revocations | GET | Revoked attestation identifiers |
/policies | GET | Active policy bundles |
swiftapi.ai protected authority APIs
| Endpoint | Method | Scope | Description |
|---|---|---|---|
/verify | POST | verify | Issue an execution attestation |
/attest | POST | verify | Issue an attestation with action data |
/chat/vibe | POST | verify | Attestation-gated Chat Completions proxy |
/attestation/revoke | POST | verify | Revoke an attestation by JTI |
/grants | POST | grants | Create a delegated grant |
/grants/{id} | DELETE | grants | Revoke a grant |
/policy/bundles | POST | policy | Upload a policy bundle |
/policy/proposals | POST | policy | Create a policy proposal |
/policy/activate | POST | policy | Activate a policy bundle |
/authority/keys | POST | admin | Create an authority key |
/authority/denials | GET | admin | View the denial log |
/governance/events | GET | admin | Query the policy decision audit trail |
Protected authority endpoints require the X-SwiftAPI-Authority header.
OpenClaw
Canonical action families for runtime enforcement.
The optional OpenClaw extension maps raw tool names to stable action families before requesting an attestation. Strict mode blocks unknown mappings and fails closed when the authority cannot be reached.
{
"plugins": {
"entries": {
"swiftapi": {
"enabled": true,
"config": {
"key": "swiftapi_live_...",
"failClosed": true,
"strictActionTypeMapping": true
}
}
}
}
}Canonical families include runtime execution, filesystem reads and writes, control-plane operations, scheduled-job mutation, message delivery and moderation, network egress, and media generation.
Operational links