# paddock > Build agent applications on Claude Code and Codex: persistent agents in their own sandboxes, server SDKs, and a browser client SDK. - [Introduction](https://docs.paddock.build/index.md): paddock runs persistent agents on Claude Code and Codex, and gets their live state into your own UI. - [Quickstart](https://docs.paddock.build/quickstart.md): Create an agent with a server SDK, mint a session token, and chat with the agent live from a React page. - [Core concepts](https://docs.paddock.build/concepts.md): Templates, agents, sessions, turns, events, and harnesses, and how they relate. - [Templates](https://docs.paddock.build/guides/templates.md): Define a kind of agent as one versioned YAML document, check it with a dry run, and save an agent's configuration back as a template. - [Agents and sessions](https://docs.paddock.build/guides/agents-and-sessions.md): Create agents and sessions, send messages at any time, stop turns, and find sessions by your own keys. - [Streaming to the browser](https://docs.paddock.build/guides/streaming.md): Hand a session to your frontend with a session token, and show its live state with the client SDK or React. - [Capabilities](https://docs.paddock.build/guides/capabilities.md): Give agents MCP servers, plugin marketplaces, plugins, and the skills inside them, and know when a change reaches a running session. - [Configuration](https://docs.paddock.build/guides/configuration.md): Set an agent's system prompt, environment, permissions, and model, and know which settings are fixed for each session. - [Models and BYOK](https://docs.paddock.build/guides/models.md): Run agents on paddock's model catalog with no provider account, or on your own Anthropic and OpenAI providers with your own keys. - [Triggers](https://docs.paddock.build/guides/triggers.md): Give other services a webhook URL whose rules turn their events into messages for your agents' sessions. - [Harness status](https://docs.paddock.build/guides/harness-status.md): See what a session's harness actually loaded and is doing: its context, plugins, skills, MCP servers, subagents, and workflows. - [Files](https://docs.paddock.build/guides/files.md): Read and write the files in an agent's workspace and its persistent memory. - [Claude Code](https://docs.paddock.build/harnesses/claude-code.md): Run agents on Claude Code: models, capabilities, tools, and what paddock configures for you. - [Codex](https://docs.paddock.build/harnesses/codex.md): Run agents on Codex: models, capabilities, tools, and how it differs from Claude Code. - [Console](https://docs.paddock.build/platform/console.md): paddock's web console: API keys, a Playground to talk to agents, and every template, agent, session, model, and trigger of your organization. - [Authentication](https://docs.paddock.build/platform/authentication.md): API keys for your backend, session tokens for your frontend, and what each may do. - [Errors](https://docs.paddock.build/platform/errors.md): Error codes, which errors are worth retrying, and how a failed turn reports its cause. - [Limits](https://docs.paddock.build/platform/limits.md): Sizes, counts, and timeouts the API enforces. - [Go](https://docs.paddock.build/sdks/go.md): The Go server SDK, package paddock: install, authenticate, and call every operation. - [Python](https://docs.paddock.build/sdks/python.md): The Python server SDK, paddock-sdk: install, authenticate, and call every operation, synchronously or with asyncio. - [TypeScript server](https://docs.paddock.build/sdks/typescript.md): @paddock/server: the TypeScript SDK for your backend. Install, authenticate, and call every operation. - [Browser client](https://docs.paddock.build/sdks/client.md): @paddock/client: turn a session ID and a session token into live session state in any frontend. - [React](https://docs.paddock.build/sdks/react.md): @paddock/react: the useSession hook and PaddockProvider. - [Introduction](https://docs.paddock.build/api-reference/introduction.md): The HTTP API behind every SDK: base URL, authentication, formats, IDs, lists, and errors. - [templates.create(pathOrDocument): the next version of the document's name](https://docs.paddock.build/api-reference/create-template.md) - [templates.list(): the latest version of each template](https://docs.paddock.build/api-reference/list-templates.md) - [templates.get("name"): the latest version](https://docs.paddock.build/api-reference/get-template.md) - [templates.list({ name }): every version](https://docs.paddock.build/api-reference/list-template-versions.md) - [templates.get("name@version")](https://docs.paddock.build/api-reference/get-template-version.md) - [templates.delete("name@version")](https://docs.paddock.build/api-reference/delete-template-version.md) - [models.list(): the platform models, then the project models](https://docs.paddock.build/api-reference/list-models.md) - [modelProviders.list(): the project's model providers, by name](https://docs.paddock.build/api-reference/list-model-providers.md) - [modelProviders.create(spec): verifies the key, then stores the provider](https://docs.paddock.build/api-reference/create-model-provider.md) - [modelProviders.get(name)](https://docs.paddock.build/api-reference/get-model-provider.md) - [modelProviders.update(name, patch): an omitted field keeps its value](https://docs.paddock.build/api-reference/update-model-provider.md) - [modelProviders.delete(name)](https://docs.paddock.build/api-reference/delete-model-provider.md) - [modelProviders.test(name): verifies the stored key and records the status](https://docs.paddock.build/api-reference/test-model-provider.md) - [modelProviders.test(draft): verifies a key without storing anything](https://docs.paddock.build/api-reference/test-model-provider-draft.md) - [agents.create({ template, metadata? })](https://docs.paddock.build/api-reference/create-agent.md) - [agents.list({ template?, metadata? })](https://docs.paddock.build/api-reference/list-agents.md) - [agents.get(id)](https://docs.paddock.build/api-reference/get-agent.md) - [agents.delete(id)](https://docs.paddock.build/api-reference/delete-agent.md) - [agent.export(): the effective spec as a template document](https://docs.paddock.build/api-reference/export-agent.md) - [agent.mcp.list()](https://docs.paddock.build/api-reference/list-mcp.md) - [agent.mcp.add(entry)](https://docs.paddock.build/api-reference/add-mcp.md) - [agent.mcp.get(name)](https://docs.paddock.build/api-reference/get-mcp.md) - [agent.mcp.update(name, entry)](https://docs.paddock.build/api-reference/update-mcp.md) - [agent.mcp.delete(name)](https://docs.paddock.build/api-reference/delete-mcp.md) - [agent.marketplaces.list()](https://docs.paddock.build/api-reference/list-marketplaces.md) - [agent.marketplaces.add(entry)](https://docs.paddock.build/api-reference/add-marketplaces.md) - [agent.marketplaces.get(name)](https://docs.paddock.build/api-reference/get-marketplaces.md) - [agent.marketplaces.update(name, entry)](https://docs.paddock.build/api-reference/update-marketplaces.md) - [agent.marketplaces.delete(name)](https://docs.paddock.build/api-reference/delete-marketplaces.md) - [agent.marketplaces.refresh(name): raises the entry's revision and the agent's generation](https://docs.paddock.build/api-reference/refresh-marketplace.md) - [agent.plugins.list()](https://docs.paddock.build/api-reference/list-plugins.md) - [agent.plugins.add(entry)](https://docs.paddock.build/api-reference/add-plugins.md) - [agent.plugins.get(name)](https://docs.paddock.build/api-reference/get-plugins.md) - [agent.plugins.update(name, entry)](https://docs.paddock.build/api-reference/update-plugins.md) - [agent.plugins.delete(name)](https://docs.paddock.build/api-reference/delete-plugins.md) - [agent.workflows.list()](https://docs.paddock.build/api-reference/list-workflows.md) - [agent.workflows.get(name)](https://docs.paddock.build/api-reference/get-workflow.md) - [agent.model.get()](https://docs.paddock.build/api-reference/get-model.md) - [agent.model.set(value)](https://docs.paddock.build/api-reference/set-model.md) - [agent.model.delete()](https://docs.paddock.build/api-reference/delete-model.md) - [agent.smallModelSetting.get()](https://docs.paddock.build/api-reference/get-small-model.md) - [agent.smallModelSetting.set(value)](https://docs.paddock.build/api-reference/set-small-model.md) - [agent.smallModelSetting.delete()](https://docs.paddock.build/api-reference/delete-small-model.md) - [agent.systemPrompt.get()](https://docs.paddock.build/api-reference/get-system-prompt.md) - [agent.systemPrompt.set(value)](https://docs.paddock.build/api-reference/set-system-prompt.md) - [agent.systemPrompt.delete()](https://docs.paddock.build/api-reference/delete-system-prompt.md) - [agent.env.list()](https://docs.paddock.build/api-reference/list-env.md) - [agent.env.add(entry)](https://docs.paddock.build/api-reference/add-env.md) - [agent.env.get(name)](https://docs.paddock.build/api-reference/get-env.md) - [agent.env.update(name, entry)](https://docs.paddock.build/api-reference/update-env.md) - [agent.env.delete(name)](https://docs.paddock.build/api-reference/delete-env.md) - [agent.permissions.get()](https://docs.paddock.build/api-reference/get-permissions.md) - [agent.permissions.set(spec)](https://docs.paddock.build/api-reference/set-permissions.md) - [agent.memory.list()](https://docs.paddock.build/api-reference/list-memory.md) - [agent.memory.read(path)](https://docs.paddock.build/api-reference/read-memory.md) - [agent.memory.write(path, content)](https://docs.paddock.build/api-reference/write-memory.md) - [agent.memory.delete(path)](https://docs.paddock.build/api-reference/delete-memory.md) - [agent.files.list(dir?)](https://docs.paddock.build/api-reference/list-files.md) - [agent.files.read(path)](https://docs.paddock.build/api-reference/read-file.md) - [agent.files.write(path, data)](https://docs.paddock.build/api-reference/write-file.md) - [agent.files.delete(path)](https://docs.paddock.build/api-reference/delete-file.md) - [agent.sessions.create({ cwd?, systemPrompt?, metadata? })](https://docs.paddock.build/api-reference/create-session.md) - [agent.sessions.list({ metadata? })](https://docs.paddock.build/api-reference/list-sessions.md) - [sessions.list({ agentId?, metadata?, createdAfter?, createdBefore? })](https://docs.paddock.build/api-reference/list-project-sessions.md) - [sessions.get(id)](https://docs.paddock.build/api-reference/get-session.md) - [sessions.delete(id)](https://docs.paddock.build/api-reference/delete-session.md) - [session.createToken({ ttl })](https://docs.paddock.build/api-reference/create-session-token.md) - [session.send(text)](https://docs.paddock.build/api-reference/send-message.md) - [session.stop()](https://docs.paddock.build/api-reference/stop-session.md) - [session.events.list({ after?, before?, types?, limit? })](https://docs.paddock.build/api-reference/list-events.md) - [session.stream({ after? })](https://docs.paddock.build/api-reference/stream-session.md) - [session.turns.list()](https://docs.paddock.build/api-reference/list-turns.md) - [session.turns.get(turnId)](https://docs.paddock.build/api-reference/get-turn.md) - [triggers.create(spec)](https://docs.paddock.build/api-reference/create-trigger.md) - [triggers.list(): the project's triggers, newest first](https://docs.paddock.build/api-reference/list-triggers.md) - [triggers.get(id)](https://docs.paddock.build/api-reference/get-trigger.md) - [triggers.update(id, spec): replaces the name, verification, dedupe, and rules](https://docs.paddock.build/api-reference/update-trigger.md) - [triggers.delete(id): the URL answers 404 at once; its deliveries are removed](https://docs.paddock.build/api-reference/delete-trigger.md) - [triggers.test({ trigger, event }): runs every rule on a sample event; stores and sends nothing](https://docs.paddock.build/api-reference/test-trigger.md) - [trigger.secret.get()](https://docs.paddock.build/api-reference/get-trigger-secret.md) - [trigger.secret.rotate({ secret? }): replaces the secret at once](https://docs.paddock.build/api-reference/rotate-trigger-secret.md) - [trigger.deliveries.list({ status? }): newest first by receivedAt](https://docs.paddock.build/api-reference/list-deliveries.md) - [trigger.deliveries.get(deliveryId): the delivery with its request](https://docs.paddock.build/api-reference/get-delivery.md) - [trigger.deliveries.replay(deliveryId): a new delivery of the stored request, for real](https://docs.paddock.build/api-reference/replay-delivery.md) - [Trigger webhook](https://docs.paddock.build/api-reference/webhook.md): POST https://trigger.paddock.build/{id}: the endpoint other services post events to, and how it answers. - [Pull request reviewer on GitHub](https://docs.paddock.build/examples/pr-reviewer.md): An agent that reviews every pull request of a repository, and answers when someone mentions it, with no server of your own. - [Chat app with React](https://docs.paddock.build/examples/react-chat.md): A chat application on one agent: your backend opens a session per conversation and mints its token, and a React page shows it live. ## OpenAPI Specs - [openapi](/docs/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.