v13

latestOpenAPI 3.0.0zlibraw.githubusercontent.com2026-08-01265409652.5 KB

gitops

List all GitOps workflows

Returns a list of GitOps workflows, each with its aggregated status and the artifacts it contains. Access policy: authenticated

get/gitops/workflows

Query parameters

searchstring

Search term (matches workflow name)

sort'name' | 'status' | 'creationDate' | 'lastSyncDate'

Sort field

order'asc' | 'desc'

Sort order

startinteger

Pagination start index

limitinteger

Pagination limit (0 = unlimited)

endpointIdsinteger[]

Filter by environment IDs (e.g. endpointIds[]=1&endpointIds[]=2)

status'healthy' | 'syncing' | 'error' | 'paused' | 'unknown'

Filter by status

type'stack'

Keep workflows that have at least one artifact of this type

platform'dockerStandalone' | 'dockerSwarm' | 'kubernetes'

Keep workflows that have at least one artifact on this platform

Response

creationDateinteger

idinteger required

lastSyncDateinteger

namestring required

Example response

[
  {
    "artifacts": [
      {
        "autoUpdate": {
          "Interval": "1m30s",
          "JobID": "15",
          "Webhook": "05de31a2-79fa-4644-9c12-faa67e5c49f0"
        },
        "files": [
          {
            "hash": "abc123",
            "path": "portainer.yaml",
            "ref": "refs/heads/main"
          }
        ]
      }
    ]
  }
]