createNamespace

POST

/api/v1/namespaces

curl --request POST \
  --url https://example.com/api/v1/namespaces \
  --header 'Content-Type: application/json' \
  --data '{ "description": "example", "name": "example" }'

Request Body^required

Media typeapplication/json

object

description

string

<= 2000 characters

name

required

string

<= 128 characters

key

additional properties

any

Example^generated

{
  "description": "example",
  "name": "example"
}

Responses

201

Created

Media typeapplication/json

object

description

required

string

git_source_id

string | null

head_git_sha

string

head_version

integer | null format: int64

implicit

required

True for a parent that exists only because of its children.

boolean

name

required

string

parent

string

read_only

boolean

source_type

required

string

Allowed values: managed git implicit

key

additional properties

any

Example

{
  "source_type": "managed"
}

default

Error

Media typeapplication/json

object

error

required

object

code

required

string

details

message

required

string

key

additional properties

any

key

additional properties

any

Example^generated

{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}