Send path

API reference

Paste is the demo. Put Almost in the agent loop with a Bearer key. If action is hold, do not send.

1. Create a key

Sign in → Settings → Send path→ Create API key. Prefix is almost_live_. Shown once.

2. Gate before send

POST /api/v1/gate · use this from Fin, Zendesk, Slack, or any agent step.

curl -sS -X POST https://almost.aqta.ai/api/v1/gate \
  -H "Authorization: Bearer almost_live_…" \
  -H "content-type: application/json" \
  -d '{"source":"…your policy…","draft":"…reply…"}'

You can omit source if you pinned an approved corpus in Settings. Body still needs draft.

Hold response (do not post the original). If cleared_allow_send is true, agents may post cleared_draft only.

{
  "action": "hold",
  "allow_send": false,
  "gap_claims": ["…invented line…"],
  "cleared_draft": "…source-safe reply with held units removed…",
  "cleared_allow_send": true
}

3. Check (desk-shaped)

POST /api/v1/check returns claims + a signed receipt, same engine as the desk paste.

curl -sS -X POST https://almost.aqta.ai/api/v1/check \
  -H "Authorization: Bearer almost_live_…" \
  -H "content-type: application/json" \
  -d '{"source":"…","draft":"…"}'

Guided paths

  • Clear · templates, emoji, preview, then send when invent is clear
  • Integrations · Intercom live; Zendesk, Freshdesk, HubSpot, Slack via this API
  • Verify · re-check a receipt without us