Project Branding

Manage project branding and visual identity.

GET

Get one branding profile's colors, fonts, logos and favicon

/organizations/{organizationId}/projects/{projectId}/brandings/{brandingId}

Retrieves the full details of a specific branding configuration by its unique ID within the specified project. Returns the branding's name and complete set of visual identity settings including primary and secondary colors, font selections, logo URLs, favicon, and any other configured styling properties. The branding must belong to the specified project.

Parameters

organizationIdRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

brandingIdRequired

path · stringBranding 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: "default-org" });6const { projects } = await gc.projects.listProjects({ organizationId: org.id });7
8const branding = await gc.projectBranding.getProjectBranding({9  organizationId: org.id,10  projectId: projects[0].id,11  brandingId: "target-branding-id",12});13

GET

List a project's named branding profiles: colors, fonts, logos, favicon

/organizations/{organizationId}/projects/{projectId}/brandings

Returns a paginated list of all branding configurations for the specified project. Projects can have multiple named branding profiles (e.g., 'Website Brand', 'LMS Brand'), each containing visual identity settings such as primary and secondary colors, font selections, logo URLs, and favicon. Each branding entry includes its unique ID, name, and the full set of configured styling properties.

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, createdAt, updatedAt. Direction is 'asc' or 'desc' and defaults to 'asc'.

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

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).

createdBy

query · stringFilter by createdBy. Operators: createdBy=value (equals), createdBy_ne, createdBy_gt, createdBy_gte, createdBy_lt, createdBy_lte, createdBy_like (contains), createdBy_isnull=true|false, createdBy_has=value (jsonb array contains), createdBy[]=a&createdBy[]=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).

updatedAt

query · stringFilter by updatedAt. Operators: updatedAt=value (equals), updatedAt_ne, updatedAt_gt, updatedAt_gte, updatedAt_lt, updatedAt_lte, updatedAt_like (contains), updatedAt_isnull=true|false, updatedAt_has=value (jsonb array contains), updatedAt[]=a&updatedAt[]=b (in).

organizationIdRequired

path · stringOrganization ID

projectIdRequired

path · stringProject 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" });6const { projects } = await gc.projects.listProjects({ organizationId: org.id });7
8const { brandings } = await gc.projectBrandings.listProjectBrandings({9  organizationId: org.id,10  projectId: projects[0].id,11});12

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.