Skip to content

create_namespace

Create a namespace (the container for keys). Idempotent on (project, slug): returns created=false if it already exists. slug must be lowercase letters/digits with internal hyphens (no leading/trailing hyphen, no underscore); an invalid slug returns a slug_invalid error rather than 'namespace not found'. Use this before create_key/propose_translation when the target namespace does not exist yet.

NameTypeDescription
project_uuidstringoptionalProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
slugstringrequiredNamespace slug: lowercase letters/digits + internal hyphens (e.g. common, marketing-site).
namestringrequiredHuman-readable namespace name.
descriptionstringoptional
{
"tool": "create_namespace",
"arguments": {
"slug": "<slug>",
"name": "<name>"
}
}