Menu
Platform
AI
Alerts and status pages
App store purchases
Credits
Generated Assets
Knowledge
KV
Localization
Notifications
Organizations
Payments
Queues
Realtime
Sandboxes
Storage
Workflows
API reference
- Overview
- Access API keys
- Agent sessions API
- Agent versions API
- Agents API
- AI models API
- Artifacts API
- Assets API
- Auth configs API
- Buckets API
- Builds API
- Catalogs API
- Checkout policies API
- Checkout sessions API
- Config changes API
- Config flags API
- Config segments API
- Connection providers API
- Connections API
- Connectors API
- Credit grants API
- Customer organizations API
- Customer subscriptions API
- Databases API
- Documents API
- Email domains API
- End users API
- Entities API
- Entitlement grants API
- Entries API
- Environments API
- Episodes API
- Error events API
- Error groups API
- Events API
- Exchange rates API
- Generations API
- Glossaries API
- Goals API
- Identities API
- Inbound emails API
- Inbound endpoints API
- Inbound sms API
- Invitations API
- Job runs API
- Jobs API
- Knowledge schemas API
- KV API
- KV namespaces API
- Lease events API
- Leases API
- Licence keys API
- Licence tokens API
- Mail domains API
- Mail routes API
- Mailbox connect links API
- Mailbox OAUTH apps API
- Mailboxes API
- Memberships API
- Memories API
- Memory stores API
- Merchant accounts API
- Message topics API
- Messages API
- OAUTH clients API
- Objects API
- Organization roles API
- Owner pools API
- Phone numbers API
- Portal sessions API
- Preferences API
- Price catalogs API
- Processor events API
- Projects API
- Queued executions API
- Queues API
- Realtime channels API
- Realtime members API
- Realtime messages API
- Recipients API
- Relations API
- Releases API
- Revenue API
- Revenue facts API
- Revenue sources API
- Runs API
- Sandbox shapes API
- Schedules API
- Scrubbing policies API
- Search API
- Search indexes API
- Secret versions API
- Secrets API
- Service enablements API
- Service observations API
- Services API
- Serving routes API
- Session events API
- Sessions API
- Signing key versions
- Signing keys
- Sms numbers API
- Source maps API
- Spaces API
- Store connections API
- Store purchases API
- Subscriptions API
- Suppressions API
- Tax threshold statuses API
- Templates API
- Token exchanges API
- Transfers API
- Trust policies API
- Trusted issuers API
- Uptime checks API
- Uptime manifests API
- Uptime sources API
- Usage events API
- Usage invoices API
- Usage meter prices API
- Usage meters API
- Usage reservations API
- Usage settings API
- Usage tiers API
- Volumes API
- Waits API
- Webhook deliveries API
- Webhook endpoints API
- Workflows API
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
CLI
One binary for the whole platform, generated from the same contracts as the API.
sylphx is the platform from a terminal: one binary that calls the same API
as the SDKs, generated from the same contracts. 29 services, 158 collections and
735 commands are on the pages below, and the porcelain — login, whoami,
link — is hand-written on the same SDK. The API reference is the
same surface over HTTP, and Agents and coding assistants is the
MCP server.
#Install
curl -fsSL https://sylphx.com/install/cli | bash
npm install -g @sylphx/cli
cargo install sylphx-cli --lockedThe three channels install the same sylphx binary; pick one and keep to
it, so one sylphx is on your PATH. Servers and coding agents use the
script.
The reference below follows the current API contracts. Release channels may
contain fewer commands: check sylphx --version and sylphx --help for your
installed command tree. Published CLI compatibility
lists known version differences.
#Update
There is no sylphx update: the binary does not update itself. Update the
way you installed it — the same command as Install, run again.
#Sign in
sylphx login prints a short code and waits while you approve the request in
the browser; the key is stored in your operating system's keychain.
Sign in has the flow in full. On a machine with no browser,
sylphx login --api-key - reads a key from standard input instead, and
SYLPHX_API_KEY is the key a command uses when none is stored.
#Grammar
sylphx <service> <collection> <verb> [NAME|PARENT] [--flags]- The service and collection are the tree's own names in kebab-case,
so
sylphx data databases listis thedatabasescollection of thedataservice. A collection segment is unique across the platform, so it identifies its service on its own. - The verb is the method's verb:
list,get,create,update,delete, or the verb a service adds of its own (revoke,rotate). - The positional is the resource's NAME, the parent a List runs in
(PARENT), or the ID a Create asks for, which the server assigns when
it is left out. A bare id is enough for a name below the linked project
(
sylphx link). - The flags are the request's fields in dotted kebab-case:
--spec.engineisspec.enginein the body, and an enum flag takes the contract's values.--dry-runisvalidate_only, and--parentis how a Create names the parent it creates in — every other method takes its parent, or its name, as the positional.
#Global flags
Every generated command takes the two flags the tree declares:
| Flag | Type | What it does |
|---|---|---|
--output | table|json|yaml|name | Output format; tables show name, Ready, and age. Default table. |
--from-file | path | Read the whole request body from a YAML or JSON file. |
The binary carries four more of its own, on every command:
| Flag | Type | What it does |
|---|---|---|
--api-key | KEY | The key to sign the call with; when it is left out, SYLPHX_API_KEY, then the key sylphx login stored. |
--yes | bool | Do not ask before a destructive call. |
--no-wait | bool | Return a long-running call at once instead of waiting for it. |
--all | bool | A list follows every page, not only the first. |
#Services
Every collection in the generated command contract, and its service. A collection's reference is at its own page; check the installed CLI help before using a service command.
#Service commands
A few calls belong to a service rather than to a collection, and are typed with the service alone:
| Command | Method | What it does |
|---|---|---|
sylphx access whoami | access.whoami | Returns the caller: the principal and the scope of the key or token that authenticated this request. Clients fill their org, project, and env defaults from it; every valid key may call it, whatever its scopes. |
#Porcelain
These verbs are hand-written on the same SDK rather than generated from the tree:
| Command | What it does |
|---|---|
sylphx login | Sign in: a browser approval (device flow), or an Access key with --api-key KEY|- |
sylphx logout | Revoke the stored key and forget it |
sylphx whoami | Show the caller: principal, org, project, env, scopes |
sylphx link | Link this directory to an org, project and env (.sylphx/project.json); init is the same command |
sylphx api | Call any path of the API directly (raw escape hatch): sylphx api GET /v1/whoami |
sylphx mcp | Run the Sylphx MCP server over stdio |
sylphx completion | Print a shell completion script: sylphx completion bash |