---
title: "Add GitLab Self-Managed container registry"
method: POST
path: "/containers/registries/gitlab-self"
---

# Add GitLab Self-Managed container registry

`POST /containers/registries/gitlab-self`

Add a GitLab Self-Managed (self-hosted) container registry to Aikido to scan

## Request body

- object
  - `username` string, required — The GitLab username (use the @ handle, without spaces)
  - `accesstoken` string, required — A GitLab personal or group access token with registry read permissions
  - `registry_name` string, required — The numeric GitLab group ID whose container registry should be scanned
  - `api_url` string, uri, required — The base URL of the GitLab self-managed instance (e.g. https://gitlab.example.com)

## Response `200`

The GitLab self-managed container registry has been added to aikido.

- object
  - `registry_id` integer — The id of the newly added container registry in aikido

## Other responses

- `400` — One or more of the provided fields are invalid.

---

[API](https://skmtc.net/aikido/apis/authorization.md) · [All operations](https://skmtc.net/aikido/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aikido/authorization/versions/5445e7c21137/schema)
