Add app

POST

/api/apps

• Public API (webhooks + management via Bearer token)
• Internal API (management, no auth required)

Register a new app. Saves to apps.yml and immediately queues for reconciliation.

Authorizations

• bearerToken
• None

Request Body ^required

object

id

required

App ID (lowercase letters, numbers, hyphens)

string

/^[a-z0-9][a-z0-9-]*$/

repo

required

Git repository URL

string

branch

Branch to track

string

path

Path to holden.yml in the repo

string

Responses

200

App added and queued

400

Invalid JSON or missing required fields

503

API key not configured (port 6020 only)