Coolify Octri Demo
POST/gitlab-apps

Create GitLab App

Create a new GitLab app (OAuth source). Credentials may be supplied later via the UI or update endpoint.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

11 body fields

GitLab app creation payload.

api_urlstringoptional
GitLab API URL (defaults to {html_url}/api/v4).
client_idstringoptional
GitLab OAuth Application ID.
client_secretstringoptional
GitLab OAuth Application Secret.
custom_portintegeroptional
Custom port for SSH access (default: 22).
custom_userstringoptional
Custom user for SSH access (default: git).
group_namestringoptional
Optional comma-separated group names to filter repositories.
html_urlstringrequired
GitLab instance URL (e.g., https://gitlab.com).
is_system_widebooleanoptional
Is this app system-wide (non-cloud instances only).
namestringrequired
Name of the GitLab app.
redirect_uristringoptional
OAuth redirect URI registered in GitLab.
webhook_tokenstringoptional
Webhook secret token (auto-generated when omitted).

4 status codes
201GitLab app created successfully.
api_urlstringoptional
client_idstringoptional
custom_portintegeroptional
custom_userstringoptional
group_namestringoptional
html_urlstringoptional
idintegeroptional
is_system_widebooleanoptional
namestringoptional
redirect_uristringoptional
team_idintegeroptional
uuidstringoptional
400Invalid token.
messagestringoptional
401Unauthenticated.
messagestringoptional
422Validation error.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned: Invalid token. A 401 is returned: Unauthenticated. A 422 is returned: Validation error.