Update global Git registry

PATCH

/api/v1/global-registries/git/{id}

curl --request PATCH \
  --url http://localhost:3000/api/v1/global-registries/git/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "name": "margo-official-workloads", "description": "Official Margo workload definitions", "url": "https://github.com/margo-org/workloads.git", "branch": "main", "path": "/workloads", "authType": "NONE", "credential": "ghp_xxxxxxxxxxxxxxxxxxxx", "syncIntervalMinutes": 60, "webhookSecret": "webhook-secret-123", "enabled": true, "mandatory": true, "priority": 0 }'

• Development
• Production

Updates an existing global Git registry. Requires Super Admin privileges.

Authorizations

• api-key
• bearer

Parameters

Path Parameters

id

required

string format: uuid

Git registry UUID

Request Body ^required

Media type application/json

object

name

Unique name for the registry

string

>= 2 characters <= 100 characters

Example

margo-official-workloads

description

Description of the registry purpose

string

Example

Official Margo workload definitions

url

Git repository URL

string

Example

https://github.com/margo-org/workloads.git

branch

Branch to sync from

string

Example

main

path

Subpath within the repository to scan

string

Example

/workloads

authType

Authentication type

string

Allowed values: NONE HTTPS_TOKEN SSH_KEY

credential

Credential (token or SSH key) - will be encrypted

string

Example

ghp_xxxxxxxxxxxxxxxxxxxx

syncIntervalMinutes

Sync interval in minutes

number

>= 5 <= 1440

Example

60

webhookSecret

Webhook secret for push-based sync

string

Example

webhook-secret-123

enabled

Whether the registry is enabled

boolean

mandatory

Whether this registry is mandatory for all tenants

boolean

priority

Priority in the combined registry list (lower is higher priority)

number

<= 1000

Example

0

Responses

200

Git registry updated successfully

Media type application/json

object

id

required

Registry unique identifier

string format: uuid

name

required

Unique name for the registry

string

description

Description of the registry purpose

string

url

required

Git repository URL

string

branch

required

Branch to sync from

string

path

required

Subpath within the repository to scan

string

authType

required

Authentication type

string

Allowed values: NONE HTTPS_TOKEN SSH_KEY

hasCredentials

required

Whether credentials are configured

boolean

syncIntervalMinutes

required

Sync interval in minutes

number

lastSyncAt

Last successful sync timestamp

string format: date-time

lastSyncError

Error message from last sync attempt

string

lastSyncCommit

Last synced commit hash

string

hasWebhook

required

Whether webhook is configured

boolean

enabled

required

Whether the registry is enabled

boolean

mandatory

required

Whether this registry is mandatory for all tenants

boolean

priority

required

Priority in the combined registry list

number

createdAt

required

Creation timestamp

string format: date-time

updatedAt

required

Last update timestamp

string format: date-time

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "margo-official-workloads",
  "description": "Official Margo workload definitions",
  "url": "https://github.com/margo-org/workloads.git",
  "branch": "main",
  "path": "/workloads",
  "authType": "NONE",
  "hasCredentials": false,
  "syncIntervalMinutes": 60,
  "lastSyncError": "Authentication failed",
  "lastSyncCommit": "abc123def456",
  "hasWebhook": false,
  "enabled": true,
  "mandatory": false,
  "priority": 0
}

400

Invalid input data

401

Unauthorized

403

Forbidden - Super Admin required

404

Git registry not found

409

Registry with this name already exists