latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-1127518479.8 KB

789e6ad3796c

GitLab Apps

Create GitLab App

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

post/gitlab-apps

Request body

namestring required

Name of the GitLab app.

html_urlstring required

GitLab instance URL (e.g., https://gitlab.com).

api_urlstring

GitLab API URL (defaults to {html_url}/api/v4).

custom_userstring

Custom user for SSH access (default: git).

custom_portinteger

Custom port for SSH access (default: 22).

group_namestring nullable

Optional comma-separated group names to filter repositories.

client_idstring nullable

GitLab OAuth Application ID.

client_secretstring nullable

GitLab OAuth Application Secret.

webhook_tokenstring nullable

Webhook secret token (auto-generated when omitted).

redirect_uristring nullable

OAuth redirect URI registered in GitLab.

is_system_wideboolean

Is this app system-wide (non-cloud instances only).

Response

GitLab app created successfully.

idinteger
uuidstring
namestring
api_urlstring
html_urlstring
custom_userstring
custom_portinteger
client_idstring nullable
group_namestring nullable
redirect_uristring nullable
is_system_wideboolean
team_idinteger