Skip to main content

Repositories

8 endpoints — 2 GET, 1 POST, 2 PATCH, 3 DELETE

GET /api/v1/repoAUTH

Returns repositories, optionally filtered by query parameters.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Responses

  • 200 Ok

GET /api/v1/repo/{id}AUTH

Returns a single repository by ID.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

  • 200 Ok
  • 404 Not Found

POST /api/v1/repoAUTH

Creates a new repository. May restart the proxy if a new origin is added.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Request Body

FieldTypeRequiredDescription
urlstringYes
namestringYes
projectstringYes

Responses

  • 200 Ok
  • 400 Bad Request
  • 401 Unauthorized
  • 409 Conflict
  • 500 Internal Server Error

PATCH /api/v1/repo/{id}/user/authoriseAUTH

Grants a user authorise permission on a repository.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request Body

FieldTypeRequiredDescription
usernamestringYes

Responses

  • 200 Ok
  • 400 Bad Request
  • 401 Unauthorized

PATCH /api/v1/repo/{id}/user/pushAUTH

Grants a user push permission on a repository.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request Body

FieldTypeRequiredDescription
usernamestringYes

Responses

  • 200 Ok
  • 400 Bad Request
  • 401 Unauthorized

DELETE /api/v1/repo/{id}/deleteAUTH

Deletes a repository. May restart the proxy if a proxied host is removed.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

  • 200 Ok
  • 401 Unauthorized

DELETE /api/v1/repo/{id}/user/authorise/{username}AUTH

Revokes a user's authorise permission on a repository.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes
usernamepathstringYes

Responses

  • 200 Ok
  • 400 Bad Request
  • 401 Unauthorized

DELETE /api/v1/repo/{id}/user/push/{username}AUTH

Revokes a user's push permission on a repository.

Authorization Required

This endpoint requires a valid JWT Bearer token in the Authorization header.

Parameters

NameInTypeRequiredDescription
idpathstringYes
usernamepathstringYes

Responses

  • 200 Ok
  • 400 Bad Request
  • 401 Unauthorized