Skip to main content
GET
/
namespaces
List Namespaces
curl --request GET \
  --url https://api.example.com/namespaces
[
  {
    "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"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.terminaluse.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
org_id
string | null

Filter by owner organization ID

​
limit
integer
default:50

Maximum number of results

Required range: 1 <= x <= 100
​
page_number
integer
default:1

Page number

Required range: x >= 1

Response

Successful Response

​
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