Source Control

Operations about source control

Pull changes from the remote repository

post

Requires the Source Control feature to be licensed and connected to a repository.

Authorizations

ApiKeyAuthBearerAuth

X-N8N-API-KEYstringRequired

Body

application/json

forcebooleanOptionalExample: true

autoPublishstring · enumOptional

Controls automatic workflow publishing after import:

• none: Keep workflows in their local published state (default)
• all: Publish all imported workflows
• published: Publish only workflows that were published locally before import

Default: noneExample: publishedPossible values:

Responses

200

Pull result containing the list of files that were pulled from the remote repository.

application/json

filestringRequired

idstringRequired

namestringRequired

typestring · enumRequiredPossible values:

statusstring · enumRequiredPossible values:

locationstring · enumRequiredPossible values:

conflictbooleanRequired

updatedAtstringRequired

pushedbooleanOptional

isLocalPublishedbooleanOptional

isRemoteArchivedbooleanOptional

parentFolderIdstring · nullableOptional

folderPathstring[]Optional

publishingErrorstringOptional

400

The request is invalid or provides malformed data.

409

Conflict due to uncommitted local changes or merge conflicts. The response body lists every file in the pull diff; files causing the conflict have conflict: true or status: modified. Retry with force=true to discard local changes.

application/json

post/source-control/pull

HTTPcURLJavaScriptPython

POST /api/v1/source-control/pull HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "force": true,
  "autoPublish": "published"
}

[
  {
    "file": "text",
    "id": "text",
    "name": "text",
    "type": "credential",
    "status": "new",
    "location": "local",
    "conflict": true,
    "updatedAt": "text",
    "pushed": true,
    "isLocalPublished": true,
    "isRemoteArchived": true,
    "parentFolderId": "text",
    "folderPath": [
      "text"
    ],
    "owner": {
      "type": "personal",
      "projectId": "text",
      "projectName": "text"
    },
    "publishingError": "text"
  }
]