---
title: "Preview Push Endpoint"
method: POST
path: "/v1/agents/{agent_id}/workflow/push-preview"
tags: ["Agent Workflow"]
---

# Preview Push Endpoint

`POST /v1/agents/{agent_id}/workflow/push-preview`

Return what WOULD be pushed to DFCX right now. No SDK writes.

Mirrors push()'s diff phase but skips dispatch. DFCX-only endpoint.
``force=true`` promotes conflicts into to_update / to_delete (same as push).

## Path parameters

- `agent_id` string, required

## Query parameters

- `force` boolean

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/versions/f48cef80963f/schema)