Alfred · report API

Developer API Reference

Alfred.report provides a unified HTTP interface for Siri Shortcuts voice briefings, text-to-speech synthesis, and mission execution.

Download OpenAPI 3.1 Spec

1. Voice Briefing & TTS

GET https://voice.alfred.report/voice/briefing?token={TOKEN}

Synthesizes and streams a high-definition WAV audio briefing of all active, gated, and completed missions for the authenticated tenant.

Example Request:

curl -s "https://voice.alfred.report/voice/briefing?token=YOUR_TOKEN" --output briefing.wav

Response:

Binary audio/wav stream compatible with Apple Shortcuts "Play Sound" action.

GET POST https://voice.alfred.report/voice

Synthesizes arbitrary text into natural neural voice output using MiMo neural TTS.

GET Example:

curl "https://voice.alfred.report/voice?token=YOUR_TOKEN&text=Mission%20complete" -o speech.wav

2. Mission Kernel API

GET https://alfred.report/api/command/missions

Lists current missions with full budget, evidence, and acceptance status.

Example Response:

[
  {
    "id": "m-8942",
    "objective": "Audit core web vitals for client portfolio",
    "state": "active",
    "budget": {
      "max_usd": 2.50,
      "max_tokens": 100000,
      "used_tokens": 14200
    },
    "acceptance": ["All 145 domains scanned", "Report exported to D1"],
    "created_at": 1788825600000,
    "updated_at": 1788825900000
  }
]
POST https://alfred.report/api/command/missions

Dispatches a new mission to the orchestrator queue.

Example Payload:

{
  "objective": "Verify SSL certificate expiration dates",
  "acceptance": ["Scan complete", "Alert if < 14 days remaining"],
  "budget": { "max_usd": 0.50, "max_tokens": 25000 }
}

3. Machine-Readable Context

For autonomous AI agents and crawler integrations, access the following structured discovery endpoints: