Namespace

A folder for definitions: agents, interactions, apps and the rest are deployed into a namespace.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
name	string	The namespace’s name, unique within the tenant. Routes that take {namespaceName} use it.
defaultWebDownloadPartitionId	uuid | null	The temporary knowledge base (partition) that web pages fetched by runs of this namespace’s definitions are kept in, when a run’s start names none. Null: the tenant’s default applies.
tenantId	uuid	The id of the tenant it belongs to.
id	uuid	The unique id. Use it in by-id routes and wherever another object refers to this one.
dateCreated	datetime	When it was created, in UTC.
dateUpdated	datetime	When it was last changed, in UTC.

Example

{
  "name": "...",
  "defaultWebDownloadPartitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateUpdated": "2026-10-26T12:00:00.0000000Z"
}

Where it’s used

• namespaces.create (POST /namespaces)
• namespaces.getById (GET /namespaces/by-id/{id})
• namespaces.get (GET /namespaces/by-name/{name})
• namespaces.list (GET /namespaces)
• namespaces.rename (PUT /namespaces/by-id/{id})