Skip to content

Tenants & whoami

Two read-only helpers to orient yourself before authoring.

List Itera tenants (id, slug, name, branding). Read-only. RLS allows reading all tenants; authoring is still gated per-tenant on write. Use the returned id as the tenant_id argument to create_program.

Inputs: none

Result:

{
"tenants": [
{
"id": "8f3c…",
"slug": "dfl-batch",
"name": "DevFellowship Batch",
"branding": { "…": "…" },
"created_at": "2026-06-01T…"
}
]
}

Return the caller’s Itera memberships (tenant_id + role) and which tenants they can author in. Use it to self-check before writes.

Inputs: none

Result:

{
"memberships": [
{ "tenant_id": "8f3c…", "role": "author", "created_at": "2026-07-01T…" }
],
"author_tenant_ids": ["8f3c…"]
}
  • author_tenant_ids lists the tenants where your role is one of author, instructor, tenant_admin, or owner — i.e. where writes will succeed.
  • If it’s empty, you don’t have an authoring role yet — see Authentication.