Gitea

Verify Gitea access

Changed on

Check that the base URL is a Gitea instance and that the token can reach the repository with the permissions Kaneo needs. Repository permission failures are reported in the body; invalid credentials and upstream errors return an error status. Omit accessToken to use the saved token for the unchanged base URL.

post/gitea-integration/verify

Request

  • Base URL
    https://cloud.kaneo.app/api
  • URL
    https://cloud.kaneo.app/api/gitea-integration/verify
  • Auth
    HTTP bearer

Request body

projectIdstring required
baseUrlstring uri required
accessTokenstring

Omit to verify with this project's saved token. The base URL must match the saved integration.

repositoryOwnerstring required
repositoryNamestring required

Response

Verification result

isInstalledboolean required
hasRequiredPermissionsboolean required
repositoryExistsboolean required
repositoryPrivateboolean nullable required
missingPermissionsstring[] required
messagestring 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.

Changes

  • c9984766c765Revision changes
    • info

      added the non-success response with the status

  • c7b8a842601bRevision changes
    • breaking

      removed the media type text/plain for the response with the status

    • breaking

      removed the media type text/plain for the response with the status

    • breaking

      removed the media type text/plain for the response with the status

    • breaking

      removed the media type text/plain for the response with the status

    • breaking

      removed the media type text/plain for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status