Skip to main content
POST
/
namespaces
Create Namespace
curl --request POST \
  --url https://api.example.com/namespaces \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "owner_org_id": "<string>",
  "slug": "<string>"
}
'
{
  "created_by": "<string>",
  "id": "<string>",
  "name": "<string>",
  "owner_org_id": "<string>",
  "slug": "<string>",
  "artifact_registry": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "error": "<string>",
  "error_step": "<string>",
  "gcp_sa_email": "<string>",
  "gcs_bucket": "<string>",
  "k8s_namespace": "<string>",
  "registry_sa_email": "<string>",
  "status": "READY"
}
Namespaces provide multi-tenant isolation for your agents and resources. Each namespace gets its own:
  • Kubernetes namespace for agent workloads
  • GCS bucket for file storage
  • Service account for GCP access

Body

application/json

Request model for creating a namespace.

​
name
string
required

Human-readable name.

Required string length: 1 - 255
​
owner_org_id
string
required

WorkOS organization ID that owns this namespace.

​
slug
string
required

URL-friendly unique identifier (lowercase alphanumeric and hyphens).

Required string length: 3 - 63
Pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$

Response

Successful Response

Response model for namespace.

​
created_by
string
required

member_id of the creator.

​
id
string
required

The unique identifier of the namespace.

​
name
string
required

Human-readable name for the namespace.

​
owner_org_id
string
required

WorkOS organization ID that owns this namespace.

​
slug
string
required

URL-friendly unique identifier.

​
artifact_registry
string | null

Artifact Registry repository name.

​
created_at
string<date-time> | null

When the namespace was created.

​
error
string | null

Error message if provisioning failed.

​
error_step
string | null

Which provisioning step failed (e.g., 'create_gcs_bucket').

​
gcp_sa_email
string | null

GCP service account email.

​
gcs_bucket
string | null

GCS bucket name.

​
k8s_namespace
string | null

K8s namespace name.

​
registry_sa_email
string | null

Registry service account email for token generation.

​
status
enum<string>
default:READY

Namespace status: pending, ready, or failed.

Available options:
PENDING,
READY,
FAILED