# Documentation

- [What is Fency](/docs): Fency is a flexible framework for getting AI features into production.
- [Getting started](/docs/getting-started): Get started with Fency.ai in minutes using the React SDK.
- [Publishable keys](/docs/publishable-keys): Client-side keys that are safe to expose in browser code.
- [Secret keys](/docs/secret-keys): Server-side keys for authenticating backend requests to the Fency API.
- [Agent tasks](/docs/agent-tasks): A single invocation of the agent, performing a task.
- [Memories](/docs/memories): How to mirror your application data into Fency as memories.
- Sessions
  - [Sessions](/docs/sessions): How the React SDK uses short-lived client tokens created by your server.
  - [Guardrails](/docs/sessions/guardrails): Control which memories an agent can access for a task.
  - [Allowed actions](/docs/sessions/allowed-actions): Control which actions and components an agent may declare.
  - [Background](/docs/sessions/background): Optional guidance for how the agent should explore memories.
  - [Examples](/docs/sessions/examples): Optional query and approach pairs that steer Explore Memories.
  - [Conversation](/docs/sessions/conversation): Attach an agent task to an existing conversation.

- **Integration examples**
- [Streaming chat completion](/docs/integration/streaming-chat-completion): Stream tokens as they are generated from a chat completion.
- [Structured chat completion](/docs/integration/structured-chat-completion): Extract structured JSON data from text using a Zod schema.
- [Explore memories](/docs/integration/explore-memories): Memory-grounded chat over a catalog with guard rails and conversations.
- [Document analysis](/docs/integration/document-analysis): Upload a PDF, wait for the memory.updated webhook, then extract typed data points with MemorySearch.

# API Reference

- [API Reference](/api): The Fency API is organized around REST with JSON responses and bearer authentication.
- [Secret keys](/api/authentication): Authenticate API requests with a secret key using bearer auth.
- [Pagination](/api/pagination): List endpoints share nextPageToken and previousPageToken parameters.
- [Webhooks](/api/webhooks): Receive real-time notifications when memories or agent tasks change.
- Memories: Create, list, update, and delete memories.
  - [Memories](/api/memories): Stored data that can be created, updated, and retrieved for your application.
  - [Create text memory](/api/memories/createTextMemory)
  - [Create URL memory](/api/memories/createUrlMemory)
  - [Create file memory](/api/memories/createFileMemory)
  - [Create metadata memory](/api/memories/createMetadataMemory)
  - [List memories](/api/memories/listMemories)
  - [Get memory](/api/memories/getMemory)
  - [Update memory](/api/memories/updateMemory)
  - [Delete memory](/api/memories/deleteMemory)
  - [Get memory content](/api/memories/getMemoryContent)
- Memory bulk jobs: Upsert or delete many memories in one job and poll for progress.
  - [Memory bulk jobs](/api/memory-bulk-jobs): Upsert or delete many METADATA memories in one job and poll for progress.
  - [Create memory bulk job](/api/memory-bulk-jobs/createMemoryBulkJob)
  - [Get memory bulk job](/api/memory-bulk-jobs/getMemoryBulkJobStatus)
- Memory uploads: Presigned uploads for file memories.
  - [Memory uploads](/api/memory-uploads): Presigned uploads for file memories.
  - [Uploading files for memories](/api/memory-uploads/uploading-files): Create a file memory, get a presigned upload URL, and upload the file from your server.
  - [Create memory upload](/api/memory-uploads/createMemoryUpload)
- Memory download links: Short-lived download links for file memories.
  - [Memory download links](/api/memory-download-links): Short-lived download links for file memories.
  - [Create memory download link](/api/memory-download-links/createMemoryDownloadLink)
- Memory types: Define schemas for memories.
  - [Memory types](/api/memory-types): Schemas that define metadata fields and relations for memories.
  - [List memory types](/api/memory-types/listMemoryTypes)
  - [Create memory type](/api/memory-types/createMemoryType)
  - [Get memory type](/api/memory-types/getMemoryType)
  - [Delete memory type](/api/memory-types/deleteMemoryType)
- Sessions: Issue short-lived client tokens.
  - [Sessions](/api/sessions): Short-lived tokens used to authenticate client-side operations.
  - [Create stream session](/api/sessions/createStream)
  - [Create streaming chat completion session](/api/sessions/createStreamingChatCompletion)
  - [Create structured chat completion session](/api/sessions/createStructuredChatCompletion)
  - [Create memory chat session](/api/sessions/createMemoryChat)
  - [Create memory search session](/api/sessions/createMemorySearch)
  - [Create explore memories session](/api/sessions/createExploreMemories)
  - [Create explore product session](/api/sessions/createExploreProduct)
  - [Create agent task file download session](/api/sessions/createAgentTaskFileDownload)
  - [Create get agent task response session](/api/sessions/getAgentTaskResponse)
  - [Create submit manual action result session](/api/sessions/submitManualActionResult)
- Conversations: Manage conversations used by agent tasks.
  - [Conversations](/api/conversations): Manage conversations used by agent tasks.
  - [List conversations](/api/conversations/listConversations)
  - [Create conversation](/api/conversations/createConversation)
  - [Get conversation](/api/conversations/getConversation)
  - [Search conversations](/api/conversations/searchConversations)
- Agent tasks: Inspect asynchronous agent work.
  - [Agent tasks](/api/agent-tasks): Asynchronous work such as memory chat, search, explore memories, explore product, and chat completions.
  - [List agent tasks](/api/agent-tasks/listAgentTasks)
  - [Get agent task](/api/agent-tasks/getAgentTask)
- Agent task files: Files produced by agent tasks.
  - [Agent task files](/api/agent-task-files): Files produced by agent tasks.
  - [Get agent task file](/api/agent-task-files/getAgentTaskFile)
- [Events](/api/events): Event objects notify you when memories or agent tasks change.