Chat
Manage chat conversations, messages, and prompts.
GET
Get chat conversation with paginated messages
/organizations/{organizationId}/projects/{projectId}/apps/chat/{appId}/conversations/{conversationId}Retrieve a chat conversation with cursor-based paginated messages. Without a cursor, returns the most recent messages (up to limit). Use direction=older with cursor/cursorId to load history.
Parameters
cursor
query · string
cursorId
query · string
direction
query · union
limit
query · number
organizationIdRequired
path · string
projectIdRequired
path · string
appIdRequired
path · string
conversationIdRequired
path · string
SDK
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const org = await gc.organizations.getOrganizationBySlug({ slug: "my-org" });const { projects } = await gc.projects.listProjects({ organizationId: org.id });
const conversation = await gc.chat.getChatConversation({ organizationId: org.id, projectId: projects[0].id, appId: "app-id", conversationId: "conversation-id",});
GET
List every visitor conversation in a chat app, most recently updated first
/organizations/{organizationId}/projects/{projectId}/apps/chat/{appId}/conversationsList all chat conversations for a given chat app. Returns a paginated list of conversations with their IDs, titles, visitor IDs, and timestamps. Supports search filtering by conversation title or visitor ID. Results are ordered by most recently updated first. This is an admin-only endpoint used to review and manage all customer chat conversations.
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: title, visitorId, createdAt, updatedAt. Direction is 'asc' or 'desc' and defaults to 'asc'.
search
query · stringFree-text search. Matched against: title, visitorId.
visitorId
query · stringFilter by visitorId. Operators: visitorId=value (equals), visitorId_ne, visitorId_gt, visitorId_gte, visitorId_lt, visitorId_lte, visitorId_like (contains), visitorId_isnull=true|false, visitorId_has=value (jsonb array contains), visitorId[]=a&visitorId[]=b (in).
userId
query · stringFilter by userId. Operators: userId=value (equals), userId_ne, userId_gt, userId_gte, userId_lt, userId_lte, userId_like (contains), userId_isnull=true|false, userId_has=value (jsonb array contains), userId[]=a&userId[]=b (in).
organizationIdRequired
path · string
projectIdRequired
path · string
appIdRequired
path · string
SDK
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const org = await gc.organizations.getOrganizationBySlug({ slug: "my-org" });const { projects } = await gc.projects.listProjects({ organizationId: org.id });const { apps } = await gc.projects.listProjectApps({ organizationId: org.id, projectId: projects[0].id,});
const { conversations } = await gc.chat.listChatConversations({ organizationId: org.id, projectId: projects[0].id, appId: apps[0].id,});
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.