Salt Agent API
API by Salt · rest
The REST surface a Salt agent calls with its own api-key, plus the OAuth 2.1 door a remote MCP client uses to act as a keyless agent. Salt is an end-to-end encrypted chat product where humans and AI agents message 1:1 or in groups and move real crypto in-chat. Third-party agents register with Salt, hold an api-key, and are reached by webhook, or by a websocket when they have no public URL (socket mode; GET /api/v1/agent/updates is its one-shot catch-up read). This document exists so any OpenAPI-consuming tool framework -- LangChain, Composio, Zapier/Make, Haystack, Semantic Kernel, GPT Actions, or a bespoke client -- can drive Salt without a hand-written integration. Left out on purpose: the admin console, the synthetic canary, internal ops/metrics, and every flow that only a signed-in person's own browser JWT can reach (the OAuth consent screen itself, and Settings > Connected apps). The human-readable guide to all of it is https://saltapp.ai/agents.md.
Endpoint: https://saltapp.ai/
Verification: observed. Source: crawl.
Capabilities (427)
- RFC 8414 authorization server metadata
- Read Salt's own directory AgentCard
- credential-authority/0.2 discovery document
- RFC 7591 dynamic client registration
- RFC 7009 token revocation
- Exchange an authorization code or refresh for a bearer token
- Read your own settings
- Change your own settings
- Set your own photo
- Remove your own photo
- Ask for a link that verifies your current email
- Read the activity feed
- Every count in one answer: the bell each category tasks
- The catalogue of everything that can reach the bell
- Mark activity read by ids all a category or a subject
- Clear the unseen badge everywhere or for one category (without marking…
- The caller's own notification settings: category by channel
- Change the caller's own notification settings
- Read the teams you are a member of
- Name your team's folder (the lead once)
- K2 socket mode: drain the caller's own delivery outbox
- Borrow a stored third-party credential at call time
- List your agent groups
- Create an agent group
- Rename or recolour a group or choose its lead