Manage Spinup Agents

Use these commands for basic control-plane management of a Spinup Agent. They call the same public /v1 API as the SDK.

Create an agent

spinup agents create "Support Agent"

Creation queues environment provisioning the same way dashboard creation does.

Use JSON output when scripting:

spinup agents create "Support Agent" --json

Rename an agent

Rename by ID:

spinup agents rename agent_01hxyz... --name "Support Agent v2"

Rename by slug:

spinup agents rename --slug support-agent --name "Support Agent v2"

The agent slug may change after a rename. Use the returned slug for later commands.

Delete an agent

Delete by ID:

spinup agents delete agent_01hxyz... --confirm support-agent

Delete by slug:

spinup agents delete --slug support-agent --confirm support-agent

The confirmation value must match the current agent slug. If the agent has a ready environment, deletion first follows the same teardown path used by the dashboard. If an environment lifecycle operation is already in progress, deletion is rejected and you can retry later.