Organizations

Manage organizations, ownership, and organization settings.

GET

Get a service account

/organizations/{organizationId}/service-accounts/{accountId}

Returns the full details of a specific service account, including its name, description, role, and creation metadata. Only organization owners and admins can view service account details.

Parameters

organizationIdRequired

path · stringOrganization ID

accountIdRequired

path · stringService account ID

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const org = await gc.organizations.getOrganizationBySlug({ slug: "my-org" });6
7const serviceAccount = await gc.organizations.getServiceAccount({8  organizationId: org.id,9  accountId: "acc_123456789",10});11

GET

List an organization's service accounts, newest first

/organizations/{organizationId}/service-accounts

Returns all service accounts configured for the organization. Service accounts are non-human identities used for programmatic API access via API keys. Only organization owners and admins can view service accounts.

Parameters

page

query · numberPage number to return, 1-indexed. Defaults to 1.

pageSize

query · numberItems per page (1-100). Defaults to 10.

lite

query · stringWhen 'true', return only essential fields (id, slug, title/name) to reduce payload size. Useful for context fetching and link resolution.

sort

query · stringSort specifier as 'field:direction'. Sortable fields: name, email, createdAt. Direction is 'asc' or 'desc' and defaults to 'asc'.

query · stringFree-text search. Matched against: name, email.

name

query · stringFilter by name. Operators: name=value (equals), name_ne, name_gt, name_gte, name_lt, name_lte, name_like (contains), name_isnull=true|false, name_has=value (jsonb array contains), name[]=a&name[]=b (in).

query · stringFilter by email. Operators: email=value (equals), email_ne, email_gt, email_gte, email_lt, email_lte, email_like (contains), email_isnull=true|false, email_has=value (jsonb array contains), email[]=a&email[]=b (in).

createdAt

query · stringFilter by createdAt. Operators: createdAt=value (equals), createdAt_ne, createdAt_gt, createdAt_gte, createdAt_lt, createdAt_lte, createdAt_like (contains), createdAt_isnull=true|false, createdAt_has=value (jsonb array contains), createdAt[]=a&createdAt[]=b (in).

organizationIdRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const org = await gc.organizations.getOrganizationBySlug({ slug: "my-org" });6
7const { serviceAccounts } = await gc.organizations.listServiceAccounts({8  organizationId: org.id,9});10

GET

Get one organization's name, slug, plan, status and member count by ID

/organizations/{organizationId}

Retrieves a single organization by its unique ID. Returns the full organization object including name, slug, logo URL, plan, status, member count, and timestamps. Returns 404 if the organization does not exist.

Parameters

organizationIdRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { id: organizationId } = await gc.organizations.getOrganizationBySlug({ slug: "my-org" });6
7const org = await gc.organizations.getOrganization({ organizationId });8

GET

Get an organization from a URL slug when you have no ID

/organizations/by-slug/{slug}

Retrieves a single organization by its URL-friendly slug (e.g. 'my-company'). Returns the full organization object including ID, name, slug, logo URL, plan, status, member count, and timestamps. Useful for resolving organizations from URLs or user input where the slug is known but the ID is not. Returns 404 if no organization matches the given slug.

Parameters

slugRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: org } = await gc.organizations.getOrganizationBySlug({ slug: "example-slug" });6

BuiltAutonomously With AI

This content was built autonomously. Giant Context analyzed the site, determined what was missing, created and submitted an idea and draft, which Jesse accepted and published.