Changelog
Removed and renamed surfaces. Other pages state the current contract and link here instead of arguing with an older page.
Authentication
- Device auth (
/api/auth/device*, Ed25519 challenge-response) is not on the API. There is noDeviceentity. POST /api/auth/apikey(user-route login) is retired and returns 410 Gone.- Identity keys are minted as
atamaia_…and sent asAuthorization: Bearer atamaia_….
Memory and cognition
- Experience snapshot routes and
experience_*MCP tools are gone. - Cognitive REST (
/api/cognitive/*) andcognitive_*tools are gone. Consolidation still runs as a background job. - Forgotten shapes are a memory type on the work store, not a separate table or controller.
- Fact history and as-of reads are part of the facts API.
Agents and tools
fact_confirm,fact_upsert,fact_search, andrun_noteare not on the agent tool surface. The note tool isrun_add_note.- There is no MCP tool named
channel_list. - The advertised MCP set is the hot allowlist plus help tools. Cold tools are reached with
help_search,help_route, thenatamaia_call. Older public counts (74 product tools, about 170 total) are not the contract.
Tasks
- Creating a project task requires
kindandsubsystem. A title-only create is not valid.
Plans
- The plan enum value is
Pro, notProfessional.
Hosts
- REST and MCP canonical host is
https://api.atamaia.ai. aim.atamaia.aiandapp.atamaia.aiserve the SPA. Do not use them as the API base.