---
title: "Verify Gitea access"
method: POST
path: "/gitea-integration/verify"
tags: ["Gitea"]
---

# Verify Gitea access

`POST /gitea-integration/verify`

Check that the base URL is a Gitea instance and that the token can reach the repository with the permissions Kaneo needs. Always 200 -- problems are reported in the body.

## Request body

- object
  - `projectId` string, required
  - `baseUrl` string, uri, required
  - `accessToken` string, required
  - `repositoryOwner` string, required
  - `repositoryName` string, required

## Response `200`

Verification result

- GiteaVerificationResult
  - `isInstalled` boolean, required
  - `hasRequiredPermissions` boolean, required
  - `repositoryExists` boolean, required
  - `repositoryPrivate` boolean, nullable, required
  - `missingPermissions` string[], required
  - `message` string, required — A human-readable summary to show the user.
  - `failureReason` 'not_a_gitea_instance' | 'redirected' | 'repository_not_found' | 'null', nullable, required — Why verification failed, when it did. `redirected` usually means the base URL is behind a proxy that rewrites it.

## Other responses

- `400` — Invalid body, or unknown project
- `401` — Missing or invalid credentials
- `403` — No workspace access, or missing workspace:manage_settings

## Changes

- **2026-08-24** `08bbb5bedb5d` — 2 breaking, 5 info
  - added the new required request property `projectId`
  - the `baseUrl` request property type/format changed from `string`/`` to `string`/`uri`
  - the `baseUrl` request property's minLength was decreased from `1` to `0`
  - added the non-success response with the status `400`
  - …3 more
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/gitea-integration/verify/post.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)