Get Staging Diff

GET

/api/v2/agents/{agent_id}/staging-diff

Returns a live diff of all changes in the staging agent relative to the published (main) agent. Call this before publishing to give the user a preview of exactly what will change. Returns has_changes: false if staging and main are identical.

Request

Path Params

Header Params

Responses

🟢200

application/json

Diff retrieved successfully.

Body

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https:///api/v2/agents//staging-diff' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "has_changes": true,
        "agent": {
            "property1": "string",
            "property2": "string"
        },
        "instructions": {
            "added": [
                "string"
            ],
            "removed": [
                "string"
            ]
        },
        "corpora": {
            "added": [
                {
                    "corpus_id": 0,
                    "name": "string",
                    "is_default": true,
                    "is_enabled": true
                }
            ],
            "removed": [
                {
                    "corpus_id": 0,
                    "name": "string",
                    "is_default": true,
                    "is_enabled": true
                }
            ]
        },
        "tools": {
            "added": [
                {
                    "tool_id": 0,
                    "name": "string"
                }
            ],
            "removed": [
                {
                    "tool_id": 0,
                    "name": "string"
                }
            ]
        },
        "guardrails": {
            "added": [
                {
                    "guardrail_id": 0,
                    "name": "string"
                }
            ],
            "removed": [
                {
                    "guardrail_id": 0,
                    "name": "string"
                }
            ]
        },
        "sharepoint_folders": {
            "added": [
                "string"
            ],
            "removed": [
                "string"
            ]
        },
        "mcp_action_configs": {
            "added": [
                {
                    "mcp_action_id": 0,
                    "name": "string",
                    "prompt": "string",
                    "is_enabled": true
                }
            ],
            "removed": [
                {
                    "mcp_action_id": 0,
                    "name": "string",
                    "prompt": "string",
                    "is_enabled": true
                }
            ]
        },
        "node_configs": {
            "added": [
                {
                    "node_id": 0,
                    "name": "string",
                    "node_config_id": 0
                }
            ],
            "removed": [
                {
                    "node_id": 0,
                    "name": "string",
                    "node_config_id": 0
                }
            ]
        },
        "evaluation_datasets": {
            "added": [
                {
                    "dataset_public_id": "string",
                    "metadata": {
                        "property1": "string",
                        "property2": "string"
                    }
                }
            ],
            "removed": [
                {
                    "dataset_public_id": "string",
                    "metadata": {
                        "property1": "string",
                        "property2": "string"
                    }
                }
            ]
        },
        "tags": {
            "added": [
                "string"
            ],
            "removed": [
                "string"
            ]
        }
    }
}

Get all Starred Agents of the Authenticated User

Get publish history for an agent