Create a namespace

Creates a new namespace object. A namespace enables the contextual grouping of related jobs and datasets. Namespaces must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), colons (:), slashes (/), or dots (.). A namespace is case-insensitive with a maximum length of 1024 characters. Note jobs and datasets will be unique within a namespace, but not across namespaces.

Path Parameters

namespace string required

Possible values: <= 1024 characters

The name of the namespace.

application/json

Request Body

ownerName string required

The owner of the namespace.

description string

The description of the namespace.

Responses

application/json

Schema

Example (from schema)

Schema

name string

The name of the namespace.

createdAt date-time

An ISO-8601 timestamp representing the date/time the namespace was created.

updatedAt date-time

An ISO-8601 timestamp representing the date/time the namespace was updated.

ownerName string

The owner of the namespace.

description string

The description of the namespace.

{
  "name": "my-namespace",
  "createdAt": "2019-05-09T19:49:24.201361Z",
  "updatedAt": "2019-05-09T19:49:24.201361Z",
  "ownerName": "me",
  "description": "My first namespace!"
}

PUT /namespaces/:namespace

Request

Base URL

http://localhost:5000/api/v1

namespace — path required

Body

{
  "ownerName": "me",
  "description": "My first namespace!"
}

curl / cURL
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

python / requests
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

go / native
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

nodejs / axios
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

ruby / Net::HTTP
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

csharp / RestSharp
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

php / cURL
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

java / OkHttp
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

powershell / RestMethod
curl -L -X PUT 'http://localhost:5000/api/v1/namespaces/:namespace' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "ownerName": "me",
  "description": "My first namespace!"
}'

Create a namespace​

Request

Create a namespace