Skip to content

Trigger sync for global Git registry

POST
/api/v1/global-registries/git/{id}/sync
curl --request POST \
--url http://localhost:3000/api/v1/global-registries/git/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sync \
--header 'X-API-Key: <X-API-Key>'

Triggers a manual sync operation for a global Git registry. This clones/pulls the repository and processes application manifests. Requires Super Admin privileges.

id
required
string format: uuid

Git registry UUID

Sync operation completed successfully

Media type application/json
object
success
required

Whether the sync operation completed successfully

boolean
registryId
required

The ID of the registry that was synced

string
scope
required

The scope of the sync (always “global” for global registries)

string
Allowed values: global
applicationsFound
required

Number of applications found in the repository

number
applicationsImported
required

Number of new applications imported

number
applicationsUpdated
required

Number of existing applications updated

number
errors
required

Array of error messages encountered during sync

Array<string>
syncDuration
required

Duration of the sync operation in milliseconds

number
commit

The Git commit SHA that was synced

string
Example
{
"success": true,
"registryId": "550e8400-e29b-41d4-a716-446655440000",
"scope": "global",
"applicationsFound": 5,
"applicationsImported": 2,
"applicationsUpdated": 3,
"errors": [],
"syncDuration": 1234,
"commit": "abc123def456"
}

Unauthorized

Forbidden - Super Admin required

Git registry not found

Git registry is disabled

Application service unavailable