v3
OpenAPI 3.1.02026-07-31350397683.8 KBAgent Workflow
Push Agent Workflow
Push Bluejay's stored workflow back to the agent's source provider.
force=true bypasses DFCX conflict detection (use when you want to overwrite remote drift). Non-DFCX providers ignore the flag.
create_version=true (DFCX only) snapshots the flows/playbooks the push actually changed into new immutable versions, recording them in the version ledger. Snapshotting only-changed resources keeps version counts down and is why it rides on push: the remote draft only reflects Bluejay's edits after a successful push.
Returns 409 with {conflicts} when remote has drifted and force is False. Returns 207 with {results} when some DFCX SDK calls succeed and some fail.
post/v1/agents/{agent_id}/workflow/push
Path parameters
agent_idstring required
Query parameters
branch_idstring nullable
forceboolean
create_versionboolean
version_descriptionstring nullable
Headers
X-API-Keystring required
API key required to authenticate requests.
Response
Successful Response
{"stackTrail":"paths:/v1/agents/{agent_id}/workflow/push:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}