Trigger sync for Git registry

POST

/api/v1/registries/git/{id}/sync

const url = 'http://localhost:3000/api/v1/registries/git/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sync';
const options = {method: 'POST', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Triggers a manual sync operation for a Git registry. This clones/pulls the repository and processes application manifests.

Authorizations

api-key
bearer

Parameters

Path Parameters

required

string format: uuid

Git registry UUID

Responses

200

Sync operation completed successfully

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 “tenant” for tenant registries)

string

Allowed values: tenant

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": "tenant",
  "applicationsFound": 5,
  "applicationsImported": 2,
  "applicationsUpdated": 3,
  "errors": [],
  "syncDuration": 1234,
  "commit": "abc123def456"
}

401

Unauthorized

403

Forbidden

Forbidden — caller lacks required permission

404

Git registry not found

409

Git registry is disabled

503

Application service unavailable