API 参考Agent Sessions
Create a delegated agent session
A human user authorizes an AI agent to act on their behalf with scoped permissions and a time limit. The session token is used as the agent's Bearer credential. All actions are logged with actor_type: AGENT.
Requires user-level authentication (not API key). Max session duration: 24 hours.
Authorization
apiKey AuthorizationBearer <token>
API key: Authorization: Bearer mpk_live_<key>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://motivation-money.vercel.app/api/v1/agent-sessions" \ -H "Content-Type: application/json" \ -d '{ "scopes": [ "payroll:read", "payroll:execute" ], "expires_at": "2026-04-01T18:00:00.000Z", "description": "Execute April 2026 payroll" }'Empty