Organizations
Manage organizations and members with @tektona/sdk.
tek.org manages organizations and their members. These are top-level calls and
ignore the client's org/project scope — you pass the org name explicitly.
List
list returns one Page of the organizations you
belong to. Each item includes your_role as owner, admin, or member.
Use listAll to iterate every page:
const page = await tek.org.list({ limit: 50 });
for (const org of page.items) console.log(org.name, org.display_name);
for await (const org of tek.org.listAll()) console.log(org.name);Get
const org = await tek.org.get('acme');Create
const org = await tek.org.create({
name: 'acme', // URL-safe identifier
display_name: 'Acme Inc',
});Update
name and display_name are required; the other fields are left unchanged when
omitted:
await tek.org.update('acme', {
display_name: 'Acme Incorporated',
// default_location_id: 'eu',
// default_project_role: 'writer',
});Members
listMembers returns one Page of an org's
members; listAllMembers iterates every page:
const page = await tek.org.listMembers('acme', { limit: 50 });
for (const member of page.items) console.log(member.email, member.role);
for await (const member of tek.org.listAllMembers('acme')) console.log(member.user_id);Sandbox settings
An organization's default sandbox settings — the allowed egress policies and the
default policy new sandboxes get. Uses the client's default org (or a per-call
{ org }):
const settings = await tek.org.getSandboxSettings();
// { allowed_policies, default_policy }
await tek.org.updateSandboxSettings({ default_policy: 'tektona/dev' });allowed_policies restricts what sandboxes in the org may use. Send a list to
restrict them to it, or null to allow every policy. An empty list allows none,
so no sandbox can start. Leave the field out to keep the current setting:
await tek.org.updateSandboxSettings({ allowed_policies: null });