Create a secret
Create a secret, scoped to this agent.
Use for credentials the agent needs at runtime (e.g. an API key for an MCP server or external integration). The secret value itself is never returned in any response.
POST
Create a secret
Scoping
Secrets belong to the account (workspace) that owns this agent, not the agent itself. Any other agent in the same account can be granted access to the same secret. The
agentId in the path only determines which account the secret is created under and which agent gets initial access; it does not scope lookups.Body
application/json
Last modified on September 2, 2026

