# Postede REST API

**Developer preview — coming soon.** These integrations and docs are under
development, for controlled testing only. The CLI is not published on npm or
ready for general users. No API keys are offered; access uses approved OAuth
registrations. An existing deployed MCP endpoint does not verify the new CLI
or full parity rollout. Without maintainer-approved test access and a matching
registered environment, stop before setup or API calls.

The shared authoritative API powers both CLI commands and MCP tools. The
[endpoint reference](https://postede.com/docs/api) and
[OpenAPI 3.1 contract](https://postede.com/docs/api/openapi.json) describe all
29 data/action operations. HTTP fields use camelCase; MCP/tool arguments use
snake_case. Examples use synthetic data.

## Endpoint reference

Use the [endpoint reference](https://postede.com/docs/api) or
[OpenAPI contract](https://postede.com/docs/api/openapi.json) for each operation's
scope, parameters, request schema, response fields and error statuses.

See the [API authentication protocol](https://postede.com/docs/authentication) and
[its Markdown source](https://postede.com/docs/api/authentication.md) for direct-client connection parameters, token exchange and failure handling.
