Create repository

Available in Classic and VPC

Create a repository.

Note

To integrate File Safer or Object Storage services when creating a repository, perform the following tasks first.

File Safer
- Subscribe to service: See File Safer User Guide.
Object Storage
- Create bucket: See Object Storage User Guide or Object Storage API Guide.
- Set up integration (bucket selection) in the SourceCommit service of the NAVER Cloud Platform console: See Object Storage User Guide.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
POST	/api/v1/repository

Request headers

For information about the headers common to all SourceCommit APIs, see SourceCommit request headers.

Request body

You can include the following data in the body of your request:

Field	Type	Required	Description
`name`	String	Required	Repository name Enter 1-100 characters by combining English letters, numbers, and special characters "-" and "_".
`description`	String	Optional	Repository description (byte) 0-500
`linked`	Object	Optional	Service integration information
`linked.FileSafer`	Boolean	Optional	File Safer service integration `true` \| `false` (default) `true`: integrate `false`: not integrate
`linked.ObjectStorage`	Boolean	Optional	Object Storage service integration `true` \| `false` (default) `true`: integrate `false`: not integrate

Request example

The request example is as follows:

curl --location --request POST 'https://sourcecommit.apigw.ntruss.com/api/v1/repository' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
  "name": "repository001",
  "description": "repository001",
  "linked": {
    "FileSafer": true,
    "ObjectStorage": false
  }
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`result`	Boolean	-	API call success status Upon success, display `true`. No field is displayed upon failure.

Response status codes

For information about the HTTP status codes common to all SourceCommit APIs, see SourceCommit response status codes.

Response example

The response example is as follows:

{
    "result": true
}