repositories

create repository

Changed on
post/repositories

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/repositories
  • Auth
    • HTTP bearer
    • or HTTP basic
    • or API key in cookie internal_auth_session

Query parameters

bareboolean

If true, create a bare repository with no initial commit and branch

Request body

namestring required
storage_idstring

Unique identifier of the underlying data store. EXPERIMENTAL

storage_namespacestring required

Filesystem URI to store the underlying data in (e.g. "s3://my-bucket/some/path/")

default_branchstring
sample_databoolean
read_onlyboolean

Example request

{
  "storage_namespace": "s3://example-bucket/",
  "default_branch": "main",
  "sample_data": true,
  "read_only": true
}

Response

repository

idstring required
creation_dateinteger required

Unix Epoch in seconds

default_branchstring required
storage_idstring

Unique identifier of the underlying data store. EXPERIMENTAL

storage_namespacestring required

Filesystem URI to store the underlying data in (e.g. "s3://my-bucket/some/path/")

read_onlyboolean

Whether the repository is a read-only repository- not relevant for bare repositories

Changes

  • 27799ffec9a5Revision changes
    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

  • 6f53578edb07Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status