Sync Background Agent
POST/api/background-agents/:id/sync
Syncs the agent to its external platform (Claude Managed Agents or AWS AgentCore). Creates or updates the external agent definition, uploads enabled skills, and stores fresh gateway credentials on the platform side.
Syncing rotates the agent's secret internally, so any previously issued plaintext secret stops working.
Only agents on the claude-managed-agents and aws-agentcore platforms can be synced.
Request
Responses
- 200
- 400
- 401
- 404
- 500
- 502
Agent synced successfully
Agent cannot be synced (unsupported platform or platform not connected)
Authentication required or invalid token
Background agent not found
Internal server error
The external platform rejected the sync