Menu
Platform
AI
App store purchases
Credits
Database
Flags
Generated Assets
Monitoring
Notifications
Organizations
Payments
- Payments
- Payments quickstart
- Checkout policies
- Checkout sessions
- Customer subscriptions
- Entitlement grants
- Exchange rates
- Licence keys
- Licence tokens
- Merchant accounts
- Portal sessions
- Price catalogs
- Revenue
- Revenue facts
- Revenue sources
- Tax threshold statuses
- Usage events
- Usage invoices
- Usage meter prices
- Usage meters
- Usage reservations
- Usage settings
- Usage tiers
Sandboxes
Webhooks
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
Agents
An Agent is a versioned agent definition: model, instructions, tools, MCP servers, skills, memory stores, tool policy and budget.
An Agent is a versioned agent definition: model, instructions, tools, MCP servers, skills, memory stores, tool policy and budget. Each create or update that changes spec mints a new immutable AgentVersion; a session pins the version it started on, so a change never alters a running conversation.
Service Sylphx Agents · Resource type agents.sylphx.com/Agent · Name pattern orgs/{org}/projects/{project}/envs/{env}/agents/{agent} · Shape spec_status
Not available yet. Sylphx Agents is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.
#Fields
| Field | Type | What it is |
|---|---|---|
name | string | orgs/{org}/projects/{project}/envs/{env}/agents/{agent}. |
uid | string | agt_<cell><ulid>; never reused. Output only. |
meta | ResourceMeta | Resource metadata. |
spec | AgentSpec | Desired state: the definition the next version takes. Required. |
status | AgentStatus | Observed state. Output only. |
#Methods
Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.
| Method | Call | What it does |
|---|---|---|
GET | get | Gets an agent. |
GET | list | Lists agents. |
POST | create | Creates an agent and its version 1. |
PATCH | update | Updates an agent. A change to spec mints the next AgentVersion; sessions already started keep the version they pinned. |
DELETE | delete | Deletes an agent and its versions. An agent with sessions is refused with INVALID_STATE unless force is set, which deletes them too. |
#get
Gets an agent.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent · scope agents:read · effect read · not available yet · Request, response and examples
#list
Lists agents.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents · scope agents:read · effect read · not available yet · paginated · Request, response and examples
#create
Creates an agent and its version 1.
POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents · scope agents:write · effect write · not available yet · Request, response and examples
#update
Updates an agent. A change to spec mints the next AgentVersion; sessions already started keep the version they pinned.
PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent · scope agents:write · effect write · not available yet · Request, response and examples
#delete
Deletes an agent and its versions. An agent with sessions is refused with INVALID_STATE unless force is set, which deletes them too.
DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent · scope agents:write · effect destructive · not available yet · Request, response and examples