Skip to content

Admin SDK

Package: kataflax_admin_sdk. KataflaxAdminClient holds a platform JWT or personal access token and exposes typed sub-APIs for management routes under /api/....

Use it in scripts, MCP, and internal tools. Do not embed it in an end-user mobile or web app.

import 'package:kataflax_admin_sdk/kataflax_admin_sdk.dart';
final client = KataflaxAdminClient(baseUrl: 'https://api.tefily.com');
final session = await client.auth.login(
password: 'secret',
);
final key = await client.auth.createApiKey(name: 'MCP');
client.setToken(key.token!); // or export as KATAFLAX_TOKEN
final orgs = await client.organizations.list();
final projects = await client.projects.list(organizationId: orgs.first.id);
final schemas = await client.schemas.list(projects.first.id);
client.close();

Sub-APIs include: auth, projects, organizations, teams, permissionGroups, schemas, fields, endpoints, rules, dashboards, tableData, usage, files, hosting, query, strala, assistant, conversationWorkspace, git, dns, lenast, agents, llmCredentials.

Failures throw KataflaxException. Pass onUnauthorized to clear a UI session on 401.

Tefily service tokens are created with projects.createServiceToken — they are not used as the admin client bearer token. Admin calls need a platform JWT or kfx_… PAT.