👥 Users API

Site enrollment credentials with automatic expiration. Taxonomy keys define allowed categorization while auto-derived tags apply dynamically.

• Category: Platform
• Complexity: simple
• Paths: 13 | Schemas: 50
• Tier: Standard
• Related domains: system, admin

Use Cases

• Manage user accounts and tokens
• Configure user identification
• Manage user settings and preferences
• Configure implicit and known labels

Primary Resources

• user: User account for platform access
• user_role: User role for permission management
• namespace_role: Namespace-scoped role for fine-grained permissions

Endpoints

Method	Path	Description
GET	/api/config/namespaces/system/implicit_labels	GET Implicit Labels.
POST	/api/config/namespaces/{namespace}/known_label/create	Create
POST	/api/config/namespaces/{namespace}/known_label/delete	DELETE
GET	/api/config/namespaces/{namespace}/known_labels	GET
POST	/api/config/namespaces/{namespace}/known_label_key/create	Create
POST	/api/config/namespaces/{namespace}/known_label_key/delete	DELETE
GET	/api/config/namespaces/{namespace}/known_label_keys	GET
GET	/api/register/namespaces/system/get-cloud-init-config	GET Cloud Init Config.
POST	/api/register/namespaces/{metadata.namespace}/tokens	Create Token.
PUT	/api/register/namespaces/{metadata.namespace}/tokens/{metadata.name}	Replace Token.
GET	/api/register/namespaces/{namespace}/tokens	List Token.
GET	/api/register/namespaces/{namespace}/tokens/{name}	GET Token
DELETE	/api/register/namespaces/{namespace}/tokens/{name}	DELETE Token.
POST	/api/register/namespaces/{namespace}/tokens/{name}/state	Set Token State.

Links

• Interactive API Reference
• OpenAPI Specification JSON