mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy