Referencia de la API
zinn-agents
14 puntos de conexión en esta área. Cada uno tiene su propia página con sus parámetros, su respuesta y una solicitud que puede ejecutar.
| Método | Ruta | Qué hace | Permiso |
|---|---|---|---|
| POST | /v1/agent-gateway/chat/completions | OpenAI-compatible chat completions for an agent app, metered on Zinn® AI credit. | Sin clave de API |
| GET | /v1/agent-gateway/models | The models an agent may name (OpenAI list shape). | Sin clave de API |
| GET | /v1/agents | The organisation's agents, free plan slots, apps and plans. | agents.view |
| POST | /v1/agents | Deploy one agent app on a free Zinn® Agents plan slot. | agents.manage |
| DELETE | /v1/agents/{agentId} | Delete an agent and destroy its data volume. | agents.manage, agents.view |
| GET | /v1/agents/{agentId} | One agent. | agents.view |
| PATCH | /v1/agents/{agentId} | Rename an agent, choose its model, or set its monthly AI spend cap. | agents.manage |
| POST | /v1/agents/{agentId}/login | Show how to sign in to the agent app (its token or password). | agents.login.reveal |
| GET | /v1/agents/{agentId}/memory | The agent's "+1 GB memory" add-on — what counts now, the price per GB, how many more. | agents.view |
| POST | /v1/agents/{agentId}/memory | Buy N GB of extra memory for this agent, billed monthly per GB. | agents.manage, billing.payment.manage |
| POST | /v1/agents/{agentId}/memory/{purchaseId}/stop | Stop one memory add-on renewing; it keeps working to the end of the paid month. | agents.manage, billing.payment.manage |
| POST | /v1/agents/{agentId}/open | A one-click, single-use link that opens the agent app signed in. | agents.login.reveal, agents.view |
| POST | /v1/agents/{agentId}/pause | Pause an agent (its data is kept; it stops using compute and AI). | agents.manage, agents.view |
| POST | /v1/agents/{agentId}/resume | Resume a paused agent. | agents.manage, agents.view |