ApplicationService

ServerSideDiff performs server-side diff calculation using dry-run apply

GET

https://argocd.example.com/api/v1/applications/{appName}/server-side-diff

curl -X GET 'https://argocd.example.com/api/v1/applications/string/server-side-diff' \
  -H 'Authorization: YOUR_TOKEN'

const response = await fetch('https://argocd.example.com/api/v1/applications/string/server-side-diff', {
  method: 'GET',
  headers: {
    'Authorization': 'YOUR_TOKEN',
  },
});

const data = await response.text();

import requests

response = requests.get(
    'https://argocd.example.com/api/v1/applications/string/server-side-diff',
    headers={
        'Authorization': 'YOUR_TOKEN',
    },
)
print(response.text)

{
  "items": [
    {
      "diff": "string",
      "group": "string",
      "hook": true,
      "kind": "string",
      "liveState": "string",
      "modified": true,
      "name": "string",
      "namespace": "string",
      "normalizedLiveState": "string",
      "predictedLiveState": "string",
      "resourceVersion": "string",
      "targetState": "string"
    }
  ],
  "modified": true
}

{
  "code": 0,
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ],
  "error": "string",
  "message": "string"
}

Parameters

appNamestringrequiredpath

appNamespacestringquery

projectstringquery

targetManifestsArray<string>query

Response

200OKapplicationApplicationServerSideDiffResponse

A successful response.

Response fields application/json

itemsArray<v1alpha1ResourceDiff>

Show child attributes

ResourceDiff holds the diff between a live and target resource object in Argo CD. It is used to compare the desired state (from Git/Helm) with the actual state in the cluster.

diffstring

Diff contains the JSON patch representing the difference between the live and target resource.

Deprecated: Use NormalizedLiveState and PredictedLiveState instead to compute differences.

groupstring

Group represents the API group of the resource (e.g., "apps" for Deployments).

hookboolean

Hook indicates whether this resource is a hook resource (e.g., pre-sync or post-sync hooks).

kindstring

Kind represents the Kubernetes resource kind (e.g., "Deployment", "Service").

liveStatestring

LiveState contains the JSON-serialized resource manifest of the resource currently running in the cluster.

modifiedboolean

Modified indicates whether the live resource has changes compared to the target resource.

namestring

Name is the name of the resource.

namespacestring

Namespace specifies the namespace where the resource exists.

normalizedLiveStatestring

NormalizedLiveState contains the JSON-serialized live resource state after applying normalizations. Normalizations may include ignoring irrelevant fields like timestamps or defaults applied by Kubernetes.

predictedLiveStatestring

PredictedLiveState contains the JSON-serialized resource state that Argo CD predicts based on the combination of the normalized live state and the desired target state.

resourceVersionstring

ResourceVersion is the Kubernetes resource version, which helps in tracking changes.

targetStatestring

TargetState contains the JSON-serialized resource manifest as defined in the Git/Helm repository.

modifiedboolean

defaultruntimeError

An unexpected error response.

Response fields application/json

codeinteger<int32>

detailsArray<protobufAny>

Show child attributes

type_urlstring