Sign in
Gitea

Verify Gitea access

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.

post/gitea-integration/verify

Request body

projectIdstring required
baseUrlstring uri required
accessTokenstring required
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

Changed in 2 of the 23 revisions of this API.26

  • 08bbb5bedb5d25See the full diff
    • ▲

      added the new required request property projectId

      new-required-request-property

    • ▲

      the baseUrl request property type/format changed from string/ to string/uri

      request-property-type-changed

    • ○

      the baseUrl request property's minLength was decreased from 1 to 0

      request-property-min-length-decreased

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the required property failureReason to the response with the 200 status

      response-required-property-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 32cece1ebe431See the full diff
    • ○

      endpoint added

      endpoint-added