Sign in

v66

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0174265626.3 KB
apis

Create API namespace

Create an API namespace for organizing keys by environment, service, or product.

Use this to separate production from development keys, isolate different services, or manage multiple products. Each API gets a unique identifier and dedicated infrastructure for secure key operations.

Important: API names must be unique within your workspace and cannot be changed after creation.

Required Permissions

Your root key must have one of the following permissions:

  • api.*.create_api (to create APIs in any workspace)
post/v2/apis.createApi

Request body

namestring required

Unique identifier for this API namespace within your workspace. Use descriptive names like 'payment-service-prod' or 'user-api-dev' to clearly identify purpose and environment.

Example request

{
  "name": "payment-service-production"
}

Response

API namespace created successfully. The response contains the unique API ID for referencing this namespace in key operations.

Example response

{
  "meta": {
    "requestId": "req_123"
  },
  "data": {
    "apiId": "api_2cGKbMxRjIzhCxo1IdjH3a"
  }
}