Project Legal Documents

Manage project-specific legal documents.

POST

Publish a draft project legal document

/organizations/{organizationId}/projects/{projectId}/legal/{documentId}/publish

Publishes a draft legal document, making it immutable. Every locale listed in the project's enabled_locales must have non-empty content, otherwise the publish is rejected.

Parameters

organizationIdRequired

path · string

projectIdRequired

path · string

documentIdRequired

path · string

SDKcURL

1curl -X POST "https://api.giantcontext.com/organizations/organizationId_uuid/projects/projectId_uuid/legal/documentId_uuid/publish" \2  -H "Authorization: Bearer $API_KEY" \3  -H "Content-Type: application/json" \4  -d '{}'

GET

Get a project legal document by ID

/organizations/{organizationId}/projects/{projectId}/legal/{documentId}

Returns a single legal document version for the project, including its localized content map and publish status.

Parameters

organizationIdRequired

path · string

projectIdRequired

path · string

documentIdRequired

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" });6const { projects } = await gc.projects.listProjects({ organizationId: org.id });7
8const document = await gc.projectLegalDocuments.getProjectLegalDocument({9  organizationId: org.id,10  projectId: projects[0].id,11  documentId: "doc-123",12});13

PATCH

Update a draft project legal document

/organizations/{organizationId}/projects/{projectId}/legal/{documentId}

Updates the localized content of a draft legal document. Published documents are immutable and must be re-drafted as a new version.

Parameters

organizationIdRequired

path · string

projectIdRequired

path · string

documentIdRequired

path · string

BodyRequired

content

object

SDKcURL

1curl -X PATCH "https://api.giantcontext.com/organizations/organizationId_uuid/projects/projectId_uuid/legal/documentId_uuid" \2  -H "Authorization: Bearer $API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5  "content": "content_value"6}'

GET

List a project's legal document versions across all types, draft and published

/organizations/{organizationId}/projects/{projectId}/legal

Returns a paginated list of legal document versions for the project, including drafts and published versions across all document types (terms of service, privacy policy, acceptable use policy, cookie policy, custom).

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

type

query · stringFilter by type. Operators: type=value (equals), type_ne, type_gt, type_gte, type_lt, type_lte, type_like (contains), type_isnull=true|false, type_has=value (jsonb array contains), type[]=a&type[]=b (in).

status

query · stringFilter by status. Operators: status=value (equals), status_ne, status_gt, status_gte, status_lt, status_lte, status_like (contains), status_isnull=true|false, status_has=value (jsonb array contains), status[]=a&status[]=b (in).

organizationIdRequired

path · string

projectIdRequired

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

POST

Create a new draft project legal document

/organizations/{organizationId}/projects/{projectId}/legal

Creates a new draft legal document for the project with auto-incremented version per (project, type). Content is a record keyed by locale code; at least one locale is required before publishing.

Parameters

organizationIdRequired

path · string

projectIdRequired

path · string

BodyRequired

typeRequired

union

content

object

SDKcURL

1curl -X POST "https://api.giantcontext.com/organizations/organizationId_uuid/projects/projectId_uuid/legal" \2  -H "Authorization: Bearer $API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5  "type": "type_value",6  "content": "content_value"7}'

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.