# Agent Serve Documentation > The AI workspace where teams build, deploy, and manage AI agents. Agent Serve is the AI workspace where teams build, deploy, and manage AI agents. Connect your business tools and the major LLM providers to create agents that automate real work — visually, conversationally, or with code. ## Documentation Overview This file provides an overview of our documentation. For full content of all pages, see [llms-full.txt](https://agentserve.valnoraelric.com/docs/llms-full.txt). ## Main Sections ### Root - [Documentation](https://agentserve.valnoraelric.com/docs/) ### Agents - [Choosing what to use](https://agentserve.valnoraelric.com/docs/agents/choosing) Pick between a deterministic block, an agent tool, a custom tool, an MCP server, a workflow-as-tool, and a skill. - [Custom Tools](https://agentserve.valnoraelric.com/docs/agents/custom-tools) Create your own tools with JavaScript code and use them in Agent blocks - [Agents](https://agentserve.valnoraelric.com/docs/agents) An agent is a workflow that reasons and acts, built around Agent blocks and the features you give them. - [Using MCP tools](https://agentserve.valnoraelric.com/docs/agents/mcp) Connect external tools and services using the Model Context Protocol - [Playbooks (agent skills)](https://agentserve.valnoraelric.com/docs/agents/skills) Reusable instruction packages your agents load on demand, managed from the Playbooks tab. ### Api Reference - [Authentication](https://agentserve.valnoraelric.com/docs/api-reference/authentication) Authenticate with API keys or delegated OAuth access tokens - [Getting Started](https://agentserve.valnoraelric.com/docs/api-reference/getting-started) Base URL, OpenAPI specification, first API call, response format, error handling, and pagination - [Python](https://agentserve.valnoraelric.com/docs/api-reference/python) - [TypeScript](https://agentserve.valnoraelric.com/docs/api-reference/typescript) - [Workflow imports and workspace sync](https://agentserve.valnoraelric.com/docs/api-reference/workflow-sync) Use the v2 preview, mapping, apply, and operation-status protocol from an API or CLI client - [List Workflows](https://agentserve.valnoraelric.com/docs/api-reference/workflows/listWorkflows) List active workflows in a workspace. Use `scope=archived` to find workflows available for restoration. Supports folder and deployment filters, search, sorting, and cursor pagination. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/createWorkflowV2) Create a workflow at the workspace root or in a workflow folder. The response includes seeded blocks and their IDs for attaching edges. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Get Workflow State](https://agentserve.valnoraelric.com/docs/api-reference/workflows/getWorkflowState) Get the editable draft graph, including blocks, edges, loop and parallel containers, and variables. Use this state with Replace Workflow State to preserve workspace bindings; Export Workflow removes those bindings for portability. This read records no audit event, and `HEAD` mirrors `GET`. OAuth scope: `api:read`. - [Replace Workflow State](https://agentserve.valnoraelric.com/docs/api-reference/workflows/replaceWorkflowState) Replace the draft graph atomically; concurrent writes are last-write-wins. Recompute containers from blocks and preserve omitted variables. Foreign IDs return `409`; lint is advisory. The live deployment is unchanged. `dryRun=true` validates without saving, auditing, or notifying; `needsRedeployment` describes the pre-write state. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Apply Workflow Operations](https://agentserve.valnoraelric.com/docs/api-reference/workflows/applyWorkflowOperations) Edit the draft graph and block enablement in one write. Inspect `skipped` for failures; do not retry `deferred` edges. With `atomic=true`, skipped operations or dropped inputs return `409` (`OPERATIONS_NOT_APPLIED`) without saving. `mintedBlockIds` maps labels to generated IDs. Lint is advisory; `dryRun=true` validates without saving, auditing, or notifying. The live deployment is unchanged. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Update Workflow Variables](https://agentserve.valnoraelric.com/docs/api-reference/workflows/applyWorkflowVariables) Add, edit, or delete variables by name, applying operations in order. Values are coerced to their declared type when possible; otherwise they are stored as supplied. A batch with no changes returns `200` with `changed: false`. Read current variables with Get Workflow. OAuth scope: `api:write`. - [Duplicate Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/duplicateWorkflow) Copy a workflow's graph and variables into the same workspace. Omit `name` to reuse the source name; name collisions in the destination folder are resolved automatically. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Restore Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/restoreWorkflow) Restore an archived workflow and the schedules, webhooks, MCP tools, and chats archived with it. An active workflow returns `409`. If its folder is archived, the workflow returns to the workspace root. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Move Workflows](https://agentserve.valnoraelric.com/docs/api-reference/workflows/moveWorkflows) Move up to 100 workflows into one folder. Moves succeed or fail independently; missing, archived, or locked workflows appear in `failed`. Duplicate IDs are ignored. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Get Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/getWorkflow) Get a workflow with its variables and deployed API-trigger inputs. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Update Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/updateWorkflowV2) Update a workflow's name, description, or folder path. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Delete Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/deleteWorkflowV2) Archive a workflow and stop its schedules, webhooks, MCP tools, and chats. Use List Workflows with `scope=archived` to find it and Restore Workflow to recover it and its archived resources. Both `deleted` and `archived` acknowledge archival. OAuth scope: `api:write`. - [List Workflow Versions](https://agentserve.valnoraelric.com/docs/api-reference/workflows/listWorkflowVersionsV2) List immutable deployment versions of a workflow, newest first. OAuth scope: `api:read`. - [Compare Workflow Versions](https://agentserve.valnoraelric.com/docs/api-reference/workflows/compareWorkflowVersionsV2) Compare two deployment versions of the same workflow. Reports semantic changes, excluding canvas layout; credential-bearing values are withheld while their changes remain visible. Connections include stable block and port identifiers. The combined snapshots and the comparison result must each fit within 16 MiB. OAuth scope: `api:read`. - [Get Workflow Version](https://agentserve.valnoraelric.com/docs/api-reference/workflows/getWorkflowVersionV2) Get an immutable deployment version and its pinned workflow graph snapshot. OAuth scope: `api:read`. - [Update Workflow Version](https://agentserve.valnoraelric.com/docs/api-reference/workflows/updateWorkflowVersionV2) Update a deployment version's name or release note. Omitted fields remain unchanged; `description: null` clears the note. The graph and live version remain unchanged. Use Activate Workflow Version to make this version live. OAuth scope: `api:write`. - [Activate Workflow Version](https://agentserve.valnoraelric.com/docs/api-reference/workflows/activateWorkflowVersion) Asynchronously activate a specific deployment version, including when the workflow is not currently deployed. The draft remains unchanged. Read Get Workflow Deployment for `isDeployed` and `latestDeploymentAttempt`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Revert Workflow To Version](https://agentserve.valnoraelric.com/docs/api-reference/workflows/revertWorkflowVersion) Replace the editable draft with a deployment version, discarding current draft edits. Use `active` for the live version. The live deployment remains unchanged; Activate Workflow Version or Rollback Workflow changes it. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Workflow Deployment](https://agentserve.valnoraelric.com/docs/api-reference/workflows/getWorkflowDeployment) Get the live version, latest deployment attempt, readiness, draft changes (`needsRedeployment`), and public API access. With `isPublicApi: true`, anyone with the execution URL can run the workflow and consume billed usage without an API key. Hosted chat is managed separately. OAuth scope: `api:read`. - [Update Workflow Public API Access](https://agentserve.valnoraelric.com/docs/api-reference/workflows/updateWorkflowPublicApi) Enable or disable unauthenticated execution of the deployed workflow. Enabling allows anyone with the execution URL to consume billed usage. Organization sharing restrictions return `403` with `PUBLIC_SHARING_NOT_ALLOWED`. Hosted chat is managed separately. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Deploy Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/deployWorkflow) Create and asynchronously activate a deployment version. Every call creates a new version; retrying after a timeout can create a duplicate. Read Get Workflow Deployment to check activation. `lint` reports advisory findings for the published version; they never block the deploy. A conflicting webhook path returns `409`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Undeploy Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/undeployWorkflow) Deactivate the currently serving workflow version. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Rollback Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/rollbackWorkflow) Asynchronously activate a previous deployment version, defaulting to the preceding active version. Requires a deployed workflow and leaves the draft unchanged. Use Activate Workflow Version to select a version when the workflow is undeployed. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Export Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/exportWorkflow) Export a portable, secret-sanitized workflow; Set includeReferences=true to include non-secret source reference identities for mapped import; default exports keep their existing sanitized shape. Exporting records an audit event. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Import Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/importWorkflow) Create an undeployed workflow from a portable export object, bare state, or JSON string. Mapping options require a preview fingerprint and stable request ID; unresolved required configuration creates nothing. Mapped imports return source-to-imported block IDs and an operation receipt. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [List Chat Deployments](https://agentserve.valnoraelric.com/docs/api-reference/workflows/listChatDeployments) List hosted chats and their public URLs with cursor pagination. Filter by `workflowId` for one workflow's chat. The list requires workspace read access; Get Workflow Chat Deployment requires admin access and includes visitor access settings and customizations. Passwords are never returned. OAuth scope: `api:read`. - [Get Workflow Chat Deployment](https://agentserve.valnoraelric.com/docs/api-reference/workflows/getWorkflowChatDeployment) Get a workflow's hosted chat and visitor access settings. Requires workspace admin access; a missing chat returns `404`. Passwords are never returned; `hasPassword` indicates whether one is set. Hosted chat and workflow API deployment are managed separately. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Delete Workflow Chat Deployment](https://agentserve.valnoraelric.com/docs/api-reference/workflows/deleteWorkflowChatDeployment) Remove a workflow's hosted chat and release its URL identifier. The workflow API deployment remains active; use Undeploy Workflow to stop it. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Create or Replace Workflow Chat Deployment](https://agentserve.valnoraelric.com/docs/api-reference/workflows/replaceWorkflowChatDeployment) Create or replace a workflow's hosted chat and deploy its draft. Omitted fields reset to defaults except per-field customizations. Password authentication requires `password`; email or SSO requires non-empty `allowedEmails`. Public authentication allows anyone with the chat URL to use it. A duplicate identifier or pending deployment returns `409`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Execute Workflow](https://agentserve.valnoraelric.com/docs/api-reference/workflows/executeWorkflowV2) Execute a deployment or use `run.source: "manual"` for the draft. Manual runs require personal or OAuth write access and reject async. Public deployments allow anonymous sync or streaming. Request `application/x-ndjson` for heartbeats and the final result. Timeouts return `200` with failed status and `TIMEOUT`. Supply `X-Run-Id` to prevent duplicate execution; reuse returns `409`, never a replay. Input descriptions specify compatible modes; invalid combinations return `400`. OAuth scope: `api:write`. - [List Workflow Folders](https://agentserve.valnoraelric.com/docs/api-reference/workflows/listWorkflowsFolders) List workflow folders in a workspace. Returns the complete set in one page; `nextCursor` is always null. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create Workflow Folder](https://agentserve.valnoraelric.com/docs/api-reference/workflows/createWorkflowsFolder) Create a workflow folder in a workspace. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Rename or Move Workflow Folder](https://agentserve.valnoraelric.com/docs/api-reference/workflows/relocateWorkflowsFolder) Rename or move a workflow folder and update all descendant paths. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Delete Workflow Folder](https://agentserve.valnoraelric.com/docs/api-reference/workflows/deleteWorkflowsFolder) Archive an empty workflow folder, or set `recursive=true` to archive its subfolders and workflows. Use Restore Workflow to recover workflows. OAuth scope: `api:write`. - [List Workflow Runs](https://agentserve.valnoraelric.com/docs/api-reference/workflow-runs/listWorkflowRunsV2) List recorded runs of a workflow with filtering and opaque cursor pagination. Expired runs are permanently deleted. Retention is 30 days from run start on Free, unlimited on Pro and Team, and configured per organization on Enterprise with workspace overrides. OAuth scope: `api:read`. - [Get Workflow Run](https://agentserve.valnoraelric.com/docs/api-reference/workflow-runs/getWorkflowRunV2) Get current run state with optional final and block outputs. With `includeOutput`, `files` includes download paths; `includeFileBase64` inlines file bytes and returns `413` with the download path when one file or the total exceeds 16 MiB. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. OAuth scope: `api:read`. - [Download Workflow Run File](https://agentserve.valnoraelric.com/docs/api-reference/workflow-runs/downloadWorkflowRunFileV2) Download one run-produced file by ID. Downloads record an audit event. Expired runs are permanently deleted. Retention is 30 days from run start on Free, unlimited on Pro and Team, and configured per organization on Enterprise with workspace overrides. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. `HEAD` omits `Content-Length`; use file metadata to size downloads. OAuth scope: `api:read`. - [Resume Workflow Run](https://agentserve.valnoraelric.com/docs/api-reference/workflow-runs/resumeWorkflowRunV2) Resume one human-in-the-loop pause. The resumed attempt receives a new run ID and returns either a synchronous result or a queue receipt. OAuth scope: `api:write`. - [Cancel Workflow Run](https://agentserve.valnoraelric.com/docs/api-reference/workflow-runs/cancelRunV2) Request cancellation of a running, queued, or paused workflow run. Terminal runs return successfully without changes. A table workflow-group run returns `409` if its cell can no longer accept cancellation. OAuth scope: `api:write`. - [Preview Workspace Fork](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/previewWorkspaceFork) Preview the deployed workflows and explicitly selected resources that a new workspace fork would copy. The result is read-only and supplies the fingerprint required by Fork Workspace. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Fork Workspace](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/forkWorkspace) Create a child workspace with undeployed workflow drafts. Requires the reviewed preview fingerprint and a stable request ID. Identical retries return the same operation; reuse with different inputs returns 409. Poll Get Workspace Operation until selected resource copies complete. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Preview Workspace Push](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/previewWorkspacePush) Preview deployed source workflows replacing mapped targets along a direct fork edge. Push sends the current workspace to the other; pull brings the other into the current workspace. Proposed mappings are not saved. Dependent choices use source workflow, block, and field identities. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Push Workspace](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/pushWorkspace) Apply a reviewed push or pull with inline mappings in one transaction. Requires confirmation, the preview fingerprint, and a stable request ID. Unresolved or changed plans return 409 without applying. The receipt distinguishes committed changes from copy and deployment readiness; poll Get Workspace Operation before treating the target as ready. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Preview Workspace Pull](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/previewWorkspacePull) Preview deployed source workflows replacing mapped targets along a direct fork edge. Push sends the current workspace to the other; pull brings the other into the current workspace. Proposed mappings are not saved. Dependent choices use source workflow, block, and field identities. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Pull Workspace](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/pullWorkspace) Apply a reviewed push or pull with inline mappings in one transaction. Requires confirmation, the preview fingerprint, and a stable request ID. Unresolved or changed plans return 409 without applying. The receipt distinguishes committed changes from copy and deployment readiness; poll Get Workspace Operation before treating the target as ready. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Workspace Fork Availability](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/getWorkspaceForkAvailability) Inspect workspace fork information and copyable resources. Lineage does not grant access to the other workspace; fork creation requires source admin and sync requires admin on both sides. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Workspace Fork Lineage](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/getWorkspaceForkLineage) Inspect workspace fork information and copyable resources. Lineage does not grant access to the other workspace; fork creation requires source admin and sync requires admin on both sides. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Workspace Fork Children](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/listWorkspaceForkChildren) Inspect workspace fork information and copyable resources. Lineage does not grant access to the other workspace; fork creation requires source admin and sync requires admin on both sides. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Workspace Fork Resources](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/listWorkspaceForkResources) Inspect workspace fork information and copyable resources. Lineage does not grant access to the other workspace; fork creation requires source admin and sync requires admin on both sides. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Workspace Fork Mappings](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/getWorkspaceForkMappings) Read persisted mappings in the requested source-to-target direction. Candidate discovery uses the destination resource and selector listing operations. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Workspace Fork Mappings](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/updateWorkspaceForkMappings) Update edge mappings after validating destination resource membership and credential provider compatibility. Push addresses current-to-other mappings; pull addresses other-to-current mappings. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Rollback Workspace Fork](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/rollbackWorkspaceFork) Restore the latest sync into this workspace using its prior deployed versions. Requires target admin. It does not restore arbitrary drafts or remove every copied resource. Pending activations are reported. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Unlink Workspace Fork](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/unlinkWorkspaceFork) Remove the direct fork relationship and its mappings. Requires admin on the acting workspace. Existing workflow and resource content remains available. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Update Workspace Fork Exclusions](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/updateWorkspaceForkExclusions) Include or exclude selected workflows from fork sync. Excluded workflows are skipped as sources and targets. Missing, archived, and unchanged workflow IDs are skipped. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Preview Workflow Import](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/previewWorkflowImport) Validate destination mappings and dependent choices without creating a workflow. Returns unresolved fields, discovery instructions, and a fingerprint required by mapped import. No source workspace is queried from imported provenance. OAuth scope: `api:write`. - [List Selector Options](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/listSelector) List workspace-scoped configuration choices using the selector key and dependencies from an import or sync preview. Missing OAuth connections require human authorization before provider choices can be discovered. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Selector Option](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/getSelector) Resolve a workspace configuration option by its provider identifier and declared dependencies. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Workspace Operation](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/getWorkspaceOperation) Read a committed operation, copy progress, exact deployment readiness, and structured issues. A failed follow-up does not mean the business transaction was rolled back. OAuth scope: `api:read`. - [List Workspace Operations](https://agentserve.valnoraelric.com/docs/api-reference/workspace-sync/listWorkspaceOperations) Page committed operations newest first. Filter by the original request ID to reconcile an uncertain mutation response. OAuth scope: `api:read`. - [List Logs](https://agentserve.valnoraelric.com/docs/api-reference/logs/listLogs) List logs with filters, selectable detail, sorting, and cursor pagination. `includeJobRuns=true` includes chat and Agent Serve agent jobs only with `sortBy=startedAt`, because other orderings are unsupported. `files` contains only run-produced files; use the files API for input attachments. Expired runs are permanently deleted. Retention is 30 days from run start on Free, unlimited on Pro and Team, and configured per organization on Enterprise with workspace overrides. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Get Log](https://agentserve.valnoraelric.com/docs/api-reference/logs/getLog) Get a run's workflow graph, trace spans, final output, and cost. Trace spans expire separately, so an empty `traceSpans` array does not prove none were recorded. Expired runs are permanently deleted. Retention is 30 days from run start on Free, unlimited on Pro and Team, and configured per organization on Enterprise with workspace overrides. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Get Log Statistics](https://agentserve.valnoraelric.com/docs/api-reference/logs/getLogStats) Get run counts, success and error counts, and latency by workspace or workflow. Default bounds span recorded runs, or the last 24 hours when empty. Buckets may extend past the end. Folder filters include descendants; `workflowsTruncated` affects series, not totals. Expired runs are permanently deleted. Retention is 30 days from run start on Free, unlimited on Pro and Team, and configured per organization on Enterprise with workspace overrides. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [List Files](https://agentserve.valnoraelric.com/docs/api-reference/files/listFiles) List active workspace files with folder filtering, search, sorting, and cursor pagination. Use `scope=archived` to find files available for restoration. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create File](https://agentserve.valnoraelric.com/docs/api-reference/files/createFile) Create a workspace file from inline UTF-8 or base64 content. Use an upload session for streamed or larger files. OAuth scope: `api:write`. - [Create File Upload](https://agentserve.valnoraelric.com/docs/api-reference/files/createFileUpload) Create a resumable upload session and receive either a signed PUT URL or multipart instructions. OAuth scope: `api:write`. - [Get File Upload](https://agentserve.valnoraelric.com/docs/api-reference/files/getFileUpload) Get an upload session's state to determine whether an interrupted transfer can resume. Requires the signed upload token and current workspace access. OAuth scope: `api:read`. - [Abort File Upload](https://agentserve.valnoraelric.com/docs/api-reference/files/abortFileUpload) Abort an incomplete upload session and discard its uploaded data. Completed uploads cannot be aborted. OAuth scope: `api:write`. - [Create File Upload Part URLs](https://agentserve.valnoraelric.com/docs/api-reference/files/createFileUploadPartUrls) Create signed URLs for a bounded set of multipart upload part numbers. OAuth scope: `api:write`. - [Complete File Upload](https://agentserve.valnoraelric.com/docs/api-reference/files/completeFileUpload) Finalize an upload and register its workspace file. Repeating a completed upload returns the existing file. OAuth scope: `api:write`. - [Read File Text](https://agentserve.valnoraelric.com/docs/api-reference/files/readFileText) Extract text without changing the file. Use Unzip File to unpack archives or Download File for original bytes. Unsupported types return `400`, compiling documents return `409`, and oversized files return `413`. `degraded: true` indicates incomplete or synthesized text, such as the legacy `.pptx` fallback; `truncated: true` indicates a parser limit. OAuth scope: `api:read`. - [List File Versions](https://agentserve.valnoraelric.com/docs/api-reference/files/listFileVersions) List the versions of a file, newest first by default. Each write that changes the bytes records one; identical rewrites do not. Collaborative edits, and repeated workflow writes by one author, fold into a version under ten minutes old and written in the last five. Renames and moves are not versions. Retention removes older versions by age and plan but keeps the newest ten, so numbers can have gaps. OAuth scope: `api:read`. - [Get File Version](https://agentserve.valnoraelric.com/docs/api-reference/files/getFileVersion) Get one version of a file. A version removed by retention, or one that never existed, returns `404`. OAuth scope: `api:read`. - [Delete File Version](https://agentserve.valnoraelric.com/docs/api-reference/files/deleteFileVersion) Permanently delete one earlier version and its stored content, for example to purge a leaked value from history before retention removes it. The current version returns `409`; revert to another version first. A version that does not exist returns `404`. OAuth scope: `api:write`. - [Read File Version Text](https://agentserve.valnoraelric.com/docs/api-reference/files/readFileVersionText) Extract the text of one version, exactly as Read File Text extracts the current content. Unsupported types return `400`, compiling documents return `409`, and oversized versions return `413`. OAuth scope: `api:read`. - [Download File Version](https://agentserve.valnoraelric.com/docs/api-reference/files/downloadFileVersion) Download the bytes of one version, served exactly as Download File serves the current bytes. Generated documents use compiled artifacts, returning `409` while compiling and `413` above the rendered-size ceiling. Downloading records an audit event. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. `HEAD` omits `Content-Length`; use file metadata to size downloads. OAuth scope: `api:read`. - [Revert File Version](https://agentserve.valnoraelric.com/docs/api-reference/files/revertFileVersion) Make the content of a version current again by writing it as a new `revert` version, so the revert can itself be reverted. Open editors receive the change. Reverting to the current version writes nothing and returns `reverted: false`. A concurrent write, or an `expectedCurrentVersion` that is no longer current, returns `409`; a version above 100 MB returns `413`. OAuth scope: `api:write`. - [Bulk Download Files](https://agentserve.valnoraelric.com/docs/api-reference/files/bulkDownloadFiles) Stream selected files and recursive folder contents as a ZIP archive. Each selection parameter and the resolved set allow 100 entries; unmatched paths or excess entries return `400`. Total bytes are bounded. Downloads record an audit event. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. `HEAD` omits `Content-Length`; use file metadata to size downloads. OAuth scope: `api:read`. - [Unzip File](https://agentserve.valnoraelric.com/docs/api-reference/files/unzipFile) Extract a ZIP archive into a new sibling folder and return counts and the destination path. Use List Files to inspect its contents. Large archives can take minutes; concurrent extraction of the same archive returns `409`. Size or processing-time limits return `413`. OAuth scope: `api:write`. - [Download File](https://agentserve.valnoraelric.com/docs/api-reference/files/downloadFile) Download current file bytes. Generated documents use compiled artifacts, returning `409` while compiling and `413` above the rendered-size ceiling. Downloading records an audit event. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. `HEAD` omits `Content-Length`; use file metadata to size downloads. OAuth scope: `api:read`. - [Rename File](https://agentserve.valnoraelric.com/docs/api-reference/files/renameFile) Rename a workspace file without changing its containing folder. OAuth scope: `api:write`. - [Delete File](https://agentserve.valnoraelric.com/docs/api-reference/files/deleteFile) Archive a workspace file, retaining its stored bytes and removing API read access. List Files with `scope=archived` finds it; Restore File recovers it. Archiving an already archived file returns `404`. OAuth scope: `api:write`. - [Restore File](https://agentserve.valnoraelric.com/docs/api-reference/files/restoreFile) Restore an archived file to the workspace root. Name collisions add a `_restored` suffix; use the returned `name` and `folderPath`. An active file returns unchanged. An archived workspace returns `400`; an unresolved name collision returns `409`. OAuth scope: `api:write`. - [Get File Metadata](https://agentserve.valnoraelric.com/docs/api-reference/files/getFile) Get file metadata, its public-share configuration, and the version number of its current content. The `share` field is null when the file has never been shared. `currentVersion` identifies the content in List File Versions and is the precondition Revert File Version accepts. OAuth scope: `api:read`. - [Move Files](https://agentserve.valnoraelric.com/docs/api-reference/files/moveFileItems) Move up to 1,000 files to a folder path or the workspace root. OAuth scope: `api:write`. - [Get File Share](https://agentserve.valnoraelric.com/docs/api-reference/files/getFileShare) Get a file's public-share configuration. An unshared file returns `data: null`; a disabled share returns its configuration with `isActive: false`. OAuth scope: `api:read`. - [Enable or Disable File Share](https://agentserve.valnoraelric.com/docs/api-reference/files/upsertFileShare) Create or update a file's public share. `isActive` is required; other fields describe their behavior when access modes change. Enabling a protected mode on a previously unshared file requires its credential in the same request. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Edit File Content](https://agentserve.valnoraelric.com/docs/api-reference/files/editFileContent) Edit part of a UTF-8 file; use Replace File Content to replace it entirely. Search-and-replace requires one exact match unless `replaceAll` is true. Anchored modes match trimmed complete lines; their input descriptions specify boundary handling. Non-UTF-8 files return `400`. Concurrent writes return `409`; re-read before retrying. OAuth scope: `api:write`. - [Replace File Content](https://agentserve.valnoraelric.com/docs/api-reference/files/updateFileContent) Replace the complete contents of an existing file from UTF-8 or base64 input. A stale `expectedRevision`, or a write that raced this one, returns `409`; re-read before retrying. OAuth scope: `api:write`. - [Search File Content](https://agentserve.valnoraelric.com/docs/api-reference/files/searchFileContent) Search indexed text in active workspace files and return matching lines with file IDs and line numbers. `folderPaths` limits both results and reported coverage. Missing matches are inconclusive if `complete` is false or `indexStatus.skippedFiles` or `indexStatus.partialFiles` is nonzero. `truncated` means additional matches exist beyond `maxResults`. OAuth scope: `api:read`. - [Delete Files](https://agentserve.valnoraelric.com/docs/api-reference/files/bulkDeleteFiles) Archive up to 1,000 workspace files while retaining their stored bytes. Use Restore File to recover each file. OAuth scope: `api:write`. - [List Folders](https://agentserve.valnoraelric.com/docs/api-reference/files/listFilesFolders) List workspace file folders with parent-path filtering and sorting. Use `scope=archived` to find paths accepted by Restore Folder. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Create Folder](https://agentserve.valnoraelric.com/docs/api-reference/files/createFilesFolder) Create a folder at the supplied workspace path. OAuth scope: `api:write`. - [Rename or Move Folder](https://agentserve.valnoraelric.com/docs/api-reference/files/relocateFilesFolder) Rename or move a folder and atomically update all descendant paths. OAuth scope: `api:write`. - [Delete Folder](https://agentserve.valnoraelric.com/docs/api-reference/files/deleteFilesFolder) Archive an empty folder, or set `recursive=true` to archive its files and subfolders. Use Restore Folder to recover the archived contents. OAuth scope: `api:write`. - [Restore Folder](https://agentserve.valnoraelric.com/docs/api-reference/files/restoreFilesFolder) Restore a folder and the files and subfolders archived with it. Use the path from List Folders with `scope=archived`. A path that is not archived returns `404`. OAuth scope: `api:write`. - [List Audit Logs](https://agentserve.valnoraelric.com/docs/api-reference/audit-logs/listAuditLogs) List an organization audit trail with filters and opaque cursor pagination. Requires an Enterprise subscription and organization admin or owner access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Audit Log](https://agentserve.valnoraelric.com/docs/api-reference/audit-logs/getAuditLog) Get one organization audit-log entry. Requires an Enterprise subscription and organization admin or owner access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Tables](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTables) List active tables with folder filtering, search, sorting, and cursor pagination. Use `scope=archived` to find tables available for restoration. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create Table](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTable) Create a table with a typed column schema and optional folder placement. OAuth scope: `api:write`. - [Get Table](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTable) Get a table with its metadata, column schema, locks, and current job. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Update Table](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTable) Rename a table, edit its description, or move it to a folder. Fields are saved independently: a failed request may leave partial changes. `error.details.applied` lists saved fields; retry only the remaining fields. If absent, nothing changed. Lock flags are read-only. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Delete Table](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTable) Archive a table while retaining its rows. Use List Tables with `scope=archived` to find it and Restore Table to recover it. OAuth scope: `api:write`. - [Add Column](https://agentserve.valnoraelric.com/docs/api-reference/tables/addTableColumn) Add a typed column and return the complete resulting table schema. OAuth scope: `api:write`. - [Update Column](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTableColumn) Update a column by name and return the complete resulting table schema. OAuth scope: `api:write`. - [Delete Column](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTableColumn) Delete a column by name while preserving at least one table column. OAuth scope: `api:write`. - [List Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTableRows) List rows in default order with cursor pagination. Pages default to a 5 MB limit and may contain fewer rows than requested; continue until `nextCursor` is null. Use Query Rows for filtering and sorting. `includeRunState=true` adds per-group run outcomes and reduces the row limit. OAuth scope: `api:read`. - [Create Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableRows) Insert one row with a data object or insert a bounded batch with a rows array. Cell keys are column names. OAuth scope: `api:write`. - [Update Rows by Filter](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTableRows) Apply the same partial data patch to every row matching a non-empty predicate. OAuth scope: `api:write`. - [Delete Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTableRows) Delete rows by a non-empty predicate or an explicit bounded list of row identifiers. OAuth scope: `api:write`. - [Get Row](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTableRow) Get one row by identifier. Set `includeRunState=true` to attach the row's per-workflow-group run outcomes. OAuth scope: `api:read`. - [Update Row](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTableRow) Merge a partial data patch into one row by identifier. OAuth scope: `api:write`. - [Delete Row](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTableRow) Delete one row by identifier. OAuth scope: `api:write`. - [Upsert Row](https://agentserve.valnoraelric.com/docs/api-reference/tables/upsertTableRow) Insert a row or replace the row matching a selected unique column. On replacement, omitted columns are cleared; send the complete row. Use Update Row for a partial patch. OAuth scope: `api:write`. - [Query Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/queryTableRows) Query rows with typed predicates, sorting, and cursor pagination. Omit the predicate to match all rows. Pages default to a 5 MB limit; continue until `nextCursor` is null. Oversized predicates return `413`. `includeRunState` adds per-group outcomes and reduces the row limit. Counts are read separately and can differ from paged results if rows change. OAuth scope: `api:read`. - [Count Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/countTableRows) Count rows matching a typed predicate, or omit the predicate to count all rows. The count is read separately from row pages and can change between requests. Oversized predicates return `413`. OAuth scope: `api:read`. - [List Views](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTableViews) List saved table views, omitting references to removed columns. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Create View](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableView) Save a filter, sort, and column layout as a named presentation of a table. OAuth scope: `api:write`. - [Get View](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTableView) Get one saved table view by identifier. OAuth scope: `api:read`. - [Update View](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTableView) Rename a view, replace or shallow-merge its configuration, or promote it to the table default. OAuth scope: `api:write`. - [Delete View](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTableView) Delete a saved presentation without changing any table rows. OAuth scope: `api:write`. - [List Workflow Groups](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTableWorkflowGroups) List the workflow and enrichment groups that can be dispatched for a table. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Add Workflow Group](https://agentserve.valnoraelric.com/docs/api-reference/tables/addTableWorkflowGroup) Bind a workflow or enrichment to the table and create the columns populated by its outputs. OAuth scope: `api:write`. - [Update Workflow Group](https://agentserve.valnoraelric.com/docs/api-reference/tables/updateTableWorkflowGroup) Restructure a workflow group, its producer, outputs, or execution behavior. Repointing the group at a different workflow concurrently invalidates the resolved output types and returns `409` — retry the update. OAuth scope: `api:write`. - [Delete Workflow Group](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTableWorkflowGroup) Delete a workflow group and every table column populated by that group. OAuth scope: `api:write`. - [List Active Run Dispatches](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTableDispatches) List in-flight run dispatches for a table in one page; `nextCursor` is always null. Use Get Run Dispatch to read a settled dispatch. OAuth scope: `api:read`. - [Create Run Dispatch](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableDispatch) Start workflow or enrichment groups across all rows or selected rows. Poll Get Run Dispatch until `complete` or `canceled`. A null `dispatchId` means no dispatch is available to poll; check row outcomes with `includeRunState`. Use Cancel Run Dispatch to stop further scheduling. OAuth scope: `api:write`. - [Get Enrichment Run Detail](https://agentserve.valnoraelric.com/docs/api-reference/tables/getRowEnrichment) Get an enrichment cell's provider attempts, statuses, hosted-key costs, durations, and matching provider. Null means no run detail was recorded; `404` means the table, row, or group does not exist. OAuth scope: `api:read`. - [Run Enrichment For One Row](https://agentserve.valnoraelric.com/docs/api-reference/tables/runRowEnrichment) Start one workflow or enrichment group for a table row. Poll Get Run Dispatch using the returned `dispatchId`. A null `dispatchId` means no dispatch is available to poll; check row outcomes with `includeRunState`. OAuth scope: `api:write`. - [Search Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/searchTableRows) Search cell text for a case-insensitive substring within an optional filtered and sorted view. Returns cell coordinates, not row data; `ordinal` matches the view used by Query Rows. Results are unpaginated and capped at 1000. If `truncated` is true, narrow the search or predicate. OAuth scope: `api:read`. - [Create Table Import](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableImport) Create a CSV import. Upload sources receive signed transfer instructions; workspace-file sources start processing directly. OAuth scope: `api:write`. - [Get Table Import](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTableImport) Get an import's progress and status. During `uploading`, the signed upload token is required; omitting it returns `404`. OAuth scope: `api:read`. - [Cancel Table Import](https://agentserve.valnoraelric.com/docs/api-reference/tables/cancelTableImport) Cancel an upload or processing import. Committed row batches remain. Non-cancelable states, including `expired`, return `409`; unknown or purged imports return `404`. OAuth scope: `api:write`. - [Create Table Import Part URLs](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableImportPartUrls) Create signed URLs for multipart upload parts. Requires the `uploading` state; other states return `409`. Unknown or purged imports return `404`. OAuth scope: `api:write`. - [Complete Table Import Upload](https://agentserve.valnoraelric.com/docs/api-reference/tables/completeTableImportUpload) Verify or assemble uploaded CSV bytes and start processing under the same import ID. Requires an import awaiting upload completion; other states return `409`. Unknown or purged imports return `404`. OAuth scope: `api:write`. - [Create Table Export](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTableExport) Create a CSV or JSON export. Exports of small tables finish during the request; larger exports run asynchronously. OAuth scope: `api:write`. - [Get Table Export](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTableExport) Get a table export's progress and status. OAuth scope: `api:read`. - [Cancel Table Export](https://agentserve.valnoraelric.com/docs/api-reference/tables/cancelTableExport) Cancel an export that is still in progress. OAuth scope: `api:write`. - [Download Table Export](https://agentserve.valnoraelric.com/docs/api-reference/tables/downloadTableExport) Get a short-lived signed download URL for a completed export. Other states return `409`; an unavailable export file returns `404`. OAuth scope: `api:read`. - [Cancel Column Runs](https://agentserve.valnoraelric.com/docs/api-reference/tables/cancelTableRuns) Stop in-flight and pending workflow or enrichment cell runs across the table or one selected row. OAuth scope: `api:write`. - [List Folders](https://agentserve.valnoraelric.com/docs/api-reference/tables/listTablesFolders) List table folders, optionally limiting results to direct children of a parent path. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Create Folder](https://agentserve.valnoraelric.com/docs/api-reference/tables/createTablesFolder) Create one table-folder leaf whose parent path already exists. OAuth scope: `api:write`. - [Rename or Move Folder](https://agentserve.valnoraelric.com/docs/api-reference/tables/relocateTablesFolder) Rename or move a table folder and update all descendant paths. OAuth scope: `api:write`. - [Delete Folder](https://agentserve.valnoraelric.com/docs/api-reference/tables/deleteTablesFolder) Archive an empty folder, or set `recursive=true` to archive its tables and subfolders. Use Restore Folder to recover the archived contents. OAuth scope: `api:write`. - [Restore Folder](https://agentserve.valnoraelric.com/docs/api-reference/tables/restoreTablesFolder) Restore an archived table folder, its descendants, and tables using its former path. An archived parent moves it to the root; name conflicts may change the returned `path`. Non-archived paths return `404`. Save the path from Delete Folder, because List Folders does not include archived table folders. OAuth scope: `api:write`. - [Restore Table](https://agentserve.valnoraelric.com/docs/api-reference/tables/restoreTable) Restore a table and its archived rows, views, and workflow groups. Active tables return unchanged without a new audit event. Name conflicts may change the returned `name`. Find archived tables with List Tables and `scope=archived`. OAuth scope: `api:write`. - [Bulk Update Rows](https://agentserve.valnoraelric.com/docs/api-reference/tables/bulkUpdateTableRows) Apply separate partial patches to up to 1,000 rows, preserving omitted columns. A row outside the table rejects the entire request with `400` and lists missing IDs. Use Update Rows by Filter to apply one patch to every matching row. OAuth scope: `api:write`. - [Get Run Dispatch](https://agentserve.valnoraelric.com/docs/api-reference/tables/getTableDispatch) Get a dispatch's current state. Poll until `complete` or `canceled`; use row reads with `includeRunState` for per-cell outcomes. OAuth scope: `api:read`. - [Cancel Run Dispatch](https://agentserve.valnoraelric.com/docs/api-reference/tables/cancelTableDispatch) Stop a dispatch from scheduling more cells. Already queued or running cells continue; use Cancel Column Runs to stop them. Completed or canceled dispatches return unchanged. OAuth scope: `api:write`. - [Move Tables and Folders](https://agentserve.valnoraelric.com/docs/api-reference/tables/moveTables) Move up to 100 tables and folders to one destination. Items succeed or fail independently: covered tables are `skipped`, missing items are `notFound`, and lock or cycle failures include reasons in `failed`. An invalid destination rejects the request before any move. OAuth scope: `api:write`. - [Bulk Delete Tables and Folders](https://agentserve.valnoraelric.com/docs/api-reference/tables/bulkDeleteTables) Archive up to 100 selected tables and folders, including folder contents. Items succeed or fail independently, with `skipped`, `notFound`, and `failed` outcomes. `deletedItems` includes all descendants. Use Restore Table or Restore Folder to recover archived items. OAuth scope: `api:write`. - [List Knowledge Bases](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeBases) List active knowledge bases in a workspace with folder filtering, search, sorting, and cursor pagination. Use `scope=archived` to find knowledge bases available for restoration. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeBase) Create a knowledge base in a workspace with optional folder placement and chunking configuration. An unknown `folderPath` returns `404`. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Get Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/getKnowledgeBase) Get a knowledge base's metadata and document counts. Inaccessible knowledge bases return `404`. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Update Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeBase) Update a knowledge base's name, description, chunking configuration, or folder placement. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Delete Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeBase) Archive a knowledge base, its documents, and its connectors, pausing synchronization. Use List Knowledge Bases with `scope=archived` to find it and Restore Knowledge Base to recover it. OAuth scope: `api:write`. - [Export Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/exportKnowledgeBase) Stream a knowledge base as a bundle archive: its configuration, tag definitions, each workspace-visible document's file and chunk text, and optionally chunk vectors. Access-control lists, connector links, and credentials never leave. More than 2000 documents returns `413`. Exports record an audit event. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. `HEAD` omits `Content-Length`; use file metadata to size downloads. OAuth scope: `api:read`. - [List Knowledge Connectors](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeConnectors) List external sources connected to a knowledge base with cursor pagination. Stored API keys are never returned. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Knowledge Connector](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeConnector) Validate and connect an external source, then queue its initial synchronization. The `apiKey` field is never returned. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Knowledge Connector](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/getKnowledgeConnector) Get one connector and its ten most recent synchronization attempts. Stored API keys are never returned. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Knowledge Connector](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeConnector) Update connector source configuration, schedule, or active state. Replacing source configuration on a runnable connector queues an immediate synchronization; paused connectors retain the change without synchronizing until resumed. Source configuration cannot be replaced while synchronization is already in progress. Authentication material cannot be changed through this operation. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Knowledge Connector](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeConnector) Delete a connector and optionally its synchronized documents. Documents are retained by default. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Sync Knowledge Connector](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/syncKnowledgeConnector) Queue a connector synchronization. Rehydration forces existing documents to be fetched and indexed again. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Knowledge Connector Documents](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeConnectorDocuments) List documents produced by one connector with opaque cursor pagination. Excluded documents are omitted unless explicitly requested. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Knowledge Connector Documents](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeConnectorDocuments) Exclude connector documents from knowledge search or restore previously excluded documents. Only documents produced by the selected connector can change. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Search Knowledge](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/searchKnowledge) Search one or more knowledge bases with semantic vector retrieval, optional hybrid full-text retrieval, and structured tag filters. Every result names the `knowledgeBaseId` it came from. A request body over 2 MiB is a `413`. Reranking returns `409` when the stored results cannot pass secret-provenance enforcement. OAuth scope: `api:read`. - [List Tags](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeTags) List the knowledge base's tag definitions with display names, write slots, and field types. Filters and document reads use display names; document writes use slots. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Create Tag](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeTag) Create a tag definition. Write document values by `tagSlot` and filter by `displayName`. Omitting `tagSlot` selects a free slot; exhaustion returns `400`. An occupied slot or duplicate name returns `409`. Use Bulk Save Tag Definitions for multiple definitions. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Tag Definitions](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeTagDefinitions) Delete unused tag definitions by default. With `unused=false`, permanently delete all definitions and their values from documents and chunks. Use Delete Tag to remove one definition. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Bulk Save Tag Definitions](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/bulkSaveKnowledgeTagDefinitions) Create or update tag definitions, preserving unspecified slots. Updates require `originalDisplayName`; other entries create tags. Slot and name conflicts appear in per-definition `errors` with HTTP `200`, leaving conflicting values unchanged. Use Update Document to set tag values. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Documents](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeDocuments) List documents with filename search, state and tag filters, sorting, and cursor pagination. Tag values use display names; use List Tags to resolve the slots required for writes. OAuth scope: `api:read`. - [Upload Document](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/uploadKnowledgeDocument) Upload one document as multipart form data. Processing continues asynchronously after the document is accepted. OAuth scope: `api:write`. - [Bulk Enable or Disable Documents](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/bulkUpdateKnowledgeDocuments) Enable or disable selected documents, or use `selectAll` for the entire knowledge base. Use Delete Document to remove documents individually. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Create Document Upload](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeDocumentUpload) Create a resumable upload session and receive direct PUT or multipart transfer instructions. OAuth scope: `api:write`. - [Abort Document Upload](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/abortKnowledgeDocumentUpload) Abort an incomplete upload session and discard its uploaded data. Completed uploads cannot be aborted. OAuth scope: `api:write`. - [Create Document Upload Part URLs](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeDocumentUploadPartUrls) Create short-lived signed PUT URLs for up to 100 multipart part numbers. OAuth scope: `api:write`. - [Complete Document Upload](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/completeKnowledgeDocumentUpload) Verify a direct upload or assemble multipart parts, create the knowledge document, and queue asynchronous processing. OAuth scope: `api:write`. - [Get Document](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/getKnowledgeDocument) Get document metadata, processing status, and source connector details. OAuth scope: `api:read`. - [Update Document](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeDocument) Rename a document, change search availability, update tag slots, or requeue processing. Omitted fields remain unchanged; indexing state is read-only. Use List Tags to resolve names to slots and Get Document for source connector details, which this response omits. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Document](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeDocument) Remove a document from listings and search. Uploaded documents and their chunks are deleted. Connector documents are excluded while retaining their stored data; later synchronization does not re-add them. OAuth scope: `api:write`. - [List Folders](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeFolders) List folders in the knowledge-base folder tree with filtering and sorting. Returns the complete set in one page; `nextCursor` is always null. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:read`. - [Create Folder](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeFolder) Create a folder in the knowledge-base folder tree. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Rename or Move Folder](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/relocateKnowledgeFolder) Rename or move a folder and atomically rewrite descendant paths. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Delete Folder](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeFolder) Archive an empty folder, or set `recursive=true` to archive its subfolders and knowledge bases. Use Restore Knowledge Base to recover knowledge bases. OAuth scope: `api:write`. - [Restore Knowledge Base](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/restoreKnowledgeBase) Restore a knowledge base and the documents and connectors archived with it. Active knowledge bases return unchanged without a new audit event. An archived workspace returns `409`; an archived containing folder moves the restored knowledge base to the workspace root. Workspace folder trees exceeding 10,000 folders return `413`. OAuth scope: `api:write`. - [Index Workspace Files](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/addWorkspaceFilesToKnowledgeBase) Queue stored workspace files for indexing without re-uploading bytes. Unreadable, unsupported, or over-100 MB files appear in `failed`; valid files are queued. Partial success returns `200`. Use Get Document to poll processing after receiving document IDs. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Chunks](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeChunks) List document chunks with content search, enabled filtering, sorting, and cursor pagination. Tags use slots; use List Tags to resolve display names. Documents that have not finished processing return `409` with their current status. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Chunk](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/createKnowledgeChunk) Append a chunk, embedding it before the response so it is immediately searchable. It inherits the document's tags and next `chunkIndex`. Connector-synced chunks are read-only and return `403` with `error.details.code: "CONNECTOR_MANAGED_RESOURCE_READ_ONLY"`; change the source and re-sync, or exclude the document. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Bulk Update Chunks](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/bulkUpdateKnowledgeChunks) Enable, disable, or delete multiple chunks in one best-effort request. Unknown chunk IDs appear in `errors` without failing the request; `processed` counts matched chunks, not changes. Connector-synced chunks are read-only and return `403` with `error.details.code: "CONNECTOR_MANAGED_RESOURCE_READ_ONLY"`; change the source and re-sync, or exclude the document. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Chunk](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/getKnowledgeChunk) Get one chunk of a document, including the exact text that was embedded. Documents that have not finished processing return `409` with their current status. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Chunk](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeChunk) Correct chunk text or disable it from search. Changing `content` re-embeds immediately and recalculates document token and character counts; disabling retains the index. Connector-synced chunks are read-only and return `403` with `error.details.code: "CONNECTOR_MANAGED_RESOURCE_READ_ONLY"`; change the source and re-sync, or exclude the document. Documents that have not finished processing return `409` with their current status. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Chunk](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeChunk) Permanently remove one chunk and subtract it from document counts. Remaining `chunkIndex` values stay stable and may become non-contiguous. Connector-synced chunks are read-only and return `403` with `error.details.code: "CONNECTOR_MANAGED_RESOURCE_READ_ONLY"`; change the source and re-sync, or exclude the document. Documents that have not finished processing return `409` with their current status. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Update Tag](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/updateKnowledgeTag) Rename a tag or change its slot-compatible `fieldType`. Renaming changes read and filter names without moving the slot or its values. Slots are fixed for a tag's lifetime; an incompatible type returns `400` and requires creating a new tag. A duplicate display name returns `409`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Tag](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/deleteKnowledgeTag) Permanently delete a tag definition and its values from every document and chunk in the knowledge base. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Next Tag Slot](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/getNextKnowledgeTagSlot) Get the next available slot and remaining capacity for a field type. This does not reserve a slot. Create Tag selects a free slot when `tagSlot` is omitted. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Tag Usage](https://agentserve.valnoraelric.com/docs/api-reference/knowledge-bases/listKnowledgeTagUsage) Count the documents and chunks with a value for each defined tag. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Billing Status](https://agentserve.valnoraelric.com/docs/api-reference/billing/getBillingStatus) Get the current plan, billing standing, credit allowance, and storage quota. Pooled `credits` and `storage` are visible only to callers who can manage the payer's billing; workspace API keys receive null for both. Use List Billing Logs for credit history. OAuth scope: `api:read`. - [List Billing Logs](https://agentserve.valnoraelric.com/docs/api-reference/billing/listBillingLogs) List credit usage with source filtering and cursor pagination. The default `period` is `30d`; pagination covers only the selected time window. An inverted custom window returns `400`. OAuth scope: `api:read`. - [List Permission Groups](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/listPermissionGroups) List permission groups in an organization with cursor pagination. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Permission Group](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/createPermissionGroup) Create a permission group. A non-default group requires workspaces and initially governs everyone in them. Creating a default group demotes the previous default to an inactive group until it is assigned workspaces. Overlapping all-member scopes conflict. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Permission Group](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/getPermissionGroup) Get a permission group and its resolved settings. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Permission Group](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/updatePermissionGroup) Update a permission group. Omitted fields remain unchanged; config keys are patched and supplied arrays replace their lists. Promoting a group to default demotes the previous default; demoting without workspaceIds leaves it inactive. Overlapping member or all-member scopes conflict. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Permission Group](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/deletePermissionGroup) Permanently delete a permission group and its membership assignments. Members then inherit any other applicable restrictions. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Permission Group Members](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/listPermissionGroupMembers) List explicit membership assignments in a permission group with cursor pagination. An empty inherit group applies to everyone in its workspaces. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Add Permission Group Member](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/addPermissionGroupMember) Assign an organization member to a permission group. An existing assignment or membership in another group targeting the same workspace returns a conflict. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Remove Permission Group Member](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/removePermissionGroupMember) Remove a member by user identifier. Removing the last member from an inherit group makes it govern everyone in its workspaces; a conflicting all-member group prevents the removal. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Bulk Add Permission Group Members](https://agentserve.valnoraelric.com/docs/api-reference/permission-groups/bulkAddPermissionGroupMembers) Assign up to 1000 selected organization members, or the entire organization roster, atomically. Existing assignments are skipped and users outside the organization are ignored. Any overlapping membership conflict rejects the entire batch. Requires organization admin or owner access and active Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Organizations](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizations) List organizations the acting user belongs to. Organizations that disallow the calling credential are omitted. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Organization](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getOrganization) Get organization metadata and the acting user’s organization role. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Organization Workspaces](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationWorkspaces) List active workspaces owned by the organization. Requires organization administrator access; does not require Access Control. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Organization Members](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationMembers) List organization members by name or email. Ordinary members must have access to the member directory; organization administrators retain access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Organization Member](https://agentserve.valnoraelric.com/docs/api-reference/organizations/updateOrganizationMember) Change a member’s organization role. Requires organization administrator access. The owner’s role and memberships managed by an identity provider cannot be changed here. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Remove Organization Member](https://agentserve.valnoraelric.com/docs/api-reference/organizations/removeOrganizationMember) Remove a member and revoke their access to organization workspaces. Administrators may remove members; members may remove themselves. The organization owner cannot be removed. Owned organization resources are reassigned and the departing member’s sessions end. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Organization Invitations](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationInvitations) List invitations owned by the organization, including invitations with workspace grants. Requires organization administrator access. Expired invitations are reported without modifying them. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Organization Invitation](https://agentserve.valnoraelric.com/docs/api-reference/organizations/createOrganizationInvitation) Email an invitation to join the organization as a member or administrator. Requires organization administrator access, invitations enabled, and an available seat on an eligible plan. This grants no workspace-specific permissions. An unexpired pending invitation for the email conflicts; use Resend Organization Invitation to send it again. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Organization Invitation](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getOrganizationInvitation) Get an invitation owned by the organization. Requires organization administrator access. Use List Organization Invitation Workspaces to inspect its workspace grants. The response excludes the acceptance token. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Revoke Organization Invitation](https://agentserve.valnoraelric.com/docs/api-reference/organizations/revokeOrganizationInvitation) Cancel an unexpired pending invitation and all its workspace grants so it can no longer be accepted. Requires organization administrator access. This does not remove a person who already accepted; use Remove Organization Member for that. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Organization Invitation Workspaces](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationInvitationWorkspaces) List workspace grants attached to an invitation of any status. Includes archived workspaces still owned by the organization; workspaces moved to another organization are omitted. Requires organization administrator access. These grants describe the invitation, not the invitee's current access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Resend Organization Invitation](https://agentserve.valnoraelric.com/docs/api-reference/organizations/resendOrganizationInvitation) Email an unexpired pending invitation again, renew its expiry, and replace its previous acceptance link. Requires organization administrator access and current invitation eligibility. Retrying sends another email; inspect the invitation after a delivery failure before retrying. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List SSO Providers](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listSsoProviders) List identity providers owned by the organization. Requires organization administrator access. OIDC client secrets are redacted and SAML private keys are omitted. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Save SSO Provider](https://agentserve.valnoraelric.com/docs/api-reference/organizations/saveSsoProvider) Create or update an organization identity provider’s configuration on a verified domain. Requires organization administrator access and SSO entitlement. Existing providers return 200; creation returns 201. Omission behavior is field-specific; OIDC’s redacted secret marker preserves the saved secret. Identity changes with linked accounts conflict. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get SSO Provider](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getSsoProvider) Get an identity provider owned by the organization. Requires organization administrator access. OIDC client secrets are redacted and SAML private keys are omitted. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Delete SSO Provider](https://agentserve.valnoraelric.com/docs/api-reference/organizations/deleteSsoProvider) Remove an identity provider and clear its primary selection. Requires organization administrator access. Existing accounts, memberships, and sessions remain; sign-in falls back to another verified provider on the domain. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Set Primary SSO Provider](https://agentserve.valnoraelric.com/docs/api-reference/organizations/setPrimarySsoProvider) Make a verified organization provider handle sign-in for its domain. Requires organization administrator access. Other providers remain available for testing and later switching. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get SSO Policy](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getSsoPolicy) Get the stored organization SSO requirement and whether it is currently enforced. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update SSO Policy](https://agentserve.valnoraelric.com/docs/api-reference/organizations/updateSsoPolicy) Require or stop requiring SSO on future sign-ins. Requires organization administrator access. Enabling requires SSO entitlement and a verified provider; disabling remains available after entitlement is lost. Existing sessions remain active. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Organization Domains](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationDomains) List the organization’s domain claims with cursor pagination. Requires organization membership. Pending DNS challenge values are returned only to administrators using their own credentials. Organizations without Enterprise domain entitlement return an empty list. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Add Organization Domain](https://agentserve.valnoraelric.com/docs/api-reference/organizations/addOrganizationDomain) Claim a domain and receive its DNS TXT challenge. Requires organization administrator access and Enterprise domain entitlement. An existing claim returns 200; a new claim returns 201. A domain verified by another organization conflicts. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Verify Organization Domain](https://agentserve.valnoraelric.com/docs/api-reference/organizations/verifyOrganizationDomain) Verify domain ownership through the published DNS TXT challenge and grant domain trust to matching organization providers. Requires organization administrator access and Enterprise domain entitlement. An already-verified domain is returned unchanged. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Remove Organization Domain](https://agentserve.valnoraelric.com/docs/api-reference/organizations/removeOrganizationDomain) Remove a domain claim and revoke verified sign-in authority from matching organization providers. Requires organization administrator access and Enterprise domain entitlement. Existing accounts and memberships remain. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Organization Member Credit Limit](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getOrganizationMemberUsageLimit) Read a person’s credit cap and credits consumed in the organization billing period. Hosted only. The userId identifies an organization member or external collaborator with workspace access in this organization; it is not a membership record ID. Null means no per-person cap, while organization limits still apply. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Organization Member Credit Limit](https://agentserve.valnoraelric.com/docs/api-reference/organizations/updateOrganizationMemberUsageLimit) Set or clear a person’s credit cap. Hosted only. The userId must identify an organization member or external collaborator with workspace access in this organization. The cap is a nonnegative whole number of credits, not dollars: 0 prevents further credit-consuming usage; null removes the per-person cap. Organization limits continue to apply. Retrying the same value is safe. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Organization Usage Summary](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getOrganizationUsageSummary) Read pooled credits, a usage series, and an exact previous-period comparison when available. Requires organization administrator access and Usage Monitoring (Enterprise on hosted; enabled on self-hosted). Defaults to 30 days. Custom dates include both dates in the selected timezone and cannot exceed 92 days. Billing windows exceeding 366 days are rejected. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get Organization Usage Breakdown](https://agentserve.valnoraelric.com/docs/api-reference/organizations/getOrganizationUsageBreakdown) Read ranked organization usage by member, workspace, workflow, model, BYOK provider, or source. Requires organization administrator access and Usage Monitoring. Omitted usage is summarized in other. BYOK ranks tokens; other dimensions rank cost. More than 10,000 underlying groups returns 413; narrow the window or workspace. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Organization Usage Events](https://agentserve.valnoraelric.com/docs/api-reference/organizations/listOrganizationUsageEvents) Page through usage events, including zero-cost reporting. Requires organization administrator access and Usage Monitoring. Defaults to 30 days. Cursors retain the initial reporting window; keep filters and sort unchanged while paging. The agentserve-chat source covers both chat surfaces. Per-event rounding can produce credits=0 with hasCost=true. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Discover Workspace Access Requests](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/discoverWorkspaceAccessRequests) Discover the acting user’s access to features, integrations, models, tools, authentication methods, and member credit limits. Returns an empty list while requests are disabled. Requires access to the workspace; external collaborators use their workspace grant. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List My Workspace Access Requests](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/listMyWorkspaceAccessRequests) List only the acting user’s requests in this workspace, including resolved history and organization-wide member credit-limit requests. History remains available while requests are disabled. Requires access to the workspace; external collaborators use their workspace grant. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Workspace Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/createWorkspaceAccessRequest) Request access for the acting user using a target from discovery. Returns an existing matching pending request when applicable; the result may be closed if access is already available. Permission approvals change the governing group for all affected members. Requires access to the workspace; external collaborators use their workspace grant. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Cancel Workspace Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/cancelWorkspaceAccessRequest) Cancel the acting user’s pending request in this scope, including an organization-wide member credit-limit request. Already resolved requests are returned unchanged. Cancellation remains available while requests are disabled. Requires access to the workspace; external collaborators use their workspace grant. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Discover Organization Access Requests](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/discoverOrganizationAccessRequests) Discover the acting user’s access to features, integrations, models, tools, authentication methods, and member credit limits. Returns an empty list while requests are disabled. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List My Organization Access Requests](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/listMyOrganizationAccessRequests) List the acting user’s organization-level requests and member credit-limit requests, including resolved history. For workspace-scoped requests, use List My Workspace Access Requests. History remains available while requests are disabled. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List Organization Access Requests](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/listOrganizationAccessRequests) List requests across the organization for administrator review. Includes requests from organization members and external workspace collaborators; history remains available while requests are disabled. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Organization Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/createOrganizationAccessRequest) Request access for the acting user using a target from discovery. Returns an existing matching pending request when applicable; the result may be closed if access is already available. Permission approvals change the governing group for all affected members. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Cancel Organization Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/cancelOrganizationAccessRequest) Cancel the acting user’s pending request in this scope, including an organization-wide member credit-limit request. Already resolved requests are returned unchanged. Cancellation remains available while requests are disabled. Requires organization membership. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Preview Organization Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/previewOrganizationAccessRequest) Preview the current permission changes, affected group and audience, or member credit cap. Review canApply, changes, impact, and fingerprint before resolving. Permission changes affect the entire governing group, not only the requester. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Resolve Organization Access Request](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/resolveOrganizationAccessRequest) Apply a reviewed request or decline it with a reason. Applying requires the preview fingerprint; changed policy or membership returns a conflict. Credit requests also require a higher newLimitCredits. Already resolved requests are returned unchanged. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Organization Access Request Settings](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/getOrganizationAccessRequestSettings) Get whether the organization allows new access requests and approvals. This preference does not enable features unavailable in the deployment or subscription. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Organization Access Request Settings](https://agentserve.valnoraelric.com/docs/api-reference/access-requests/updateOrganizationAccessRequestSettings) Allow or pause new access requests and approvals. Pausing preserves history, cancellation, and decline, and does not revoke previously granted access. Requires organization administrator access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Workspaces](https://agentserve.valnoraelric.com/docs/api-reference/workspaces/listWorkspaces) List active workspaces available to the calling credential with opaque cursor pagination. A personal API key or OAuth token sees accessible workspaces that permit user-held API credentials; a workspace API key sees only its bound workspace. OAuth scope: `api:read`. - [Get Workspace](https://agentserve.valnoraelric.com/docs/api-reference/workspaces/getWorkspace) Get metadata for an accessible workspace. OAuth scope: `api:read`. - [List Workspace Members](https://agentserve.valnoraelric.com/docs/api-reference/workspaces/listWorkspaceMembers) List workspace members by email, including explicit grants and inherited organization admin access. Each member includes a stable user ID for member administration. OAuth scope: `api:read`. - [Get Workspace Permission Config](https://agentserve.valnoraelric.com/docs/api-reference/workspaces/getWorkspacePermissionConfig) Get the acting user's governing permission group and configuration for a workspace they can access. This describes permission-group restrictions, not the user's workspace role. Group and config are null when no group governs the caller; entitled indicates whether organization permission governance is active. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Workspace Invitations](https://agentserve.valnoraelric.com/docs/api-reference/workspaces/createWorkspaceInvitations) Invite people to a workspace or grant access immediately to existing organization members. Requires workspace administrator access and current invitation eligibility; organization administrator invitations also require organization administrator access. Recipients are processed independently: inspect failed even after HTTP 200, and inspect invitation status before retrying a delivery failure. Existing access is preserved. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List MCP Servers](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/listMcpServers) List MCP servers registered in a workspace, excluding request-header values and OAuth secrets. Connection metadata remains at registration defaults until List MCP Server Tools performs discovery. OAuth scope: `api:read`. - [Create MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/createMcpServer) Register an external MCP server without connecting to it. A duplicate URL returns `409`; use Update MCP Server to change the existing registration. The server remains disconnected until List MCP Server Tools succeeds. OAuth scope: `api:write`. - [Get MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/getMcpServer) Get one MCP server by identifier. Request-header values and OAuth client secrets are never returned. OAuth scope: `api:read`. - [Update MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/updateMcpServer) Update an MCP server's supplied fields. Omitted fields remain unchanged unless the field specifies otherwise. Authentication changes revoke the stored OAuth grant and reset connection metadata. Use List MCP Server Tools to reconnect. OAuth scope: `api:write`. - [Delete MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/deleteMcpServer) Remove an MCP server and revoke its OAuth tokens. Workflows retain blocks that referenced the server's tools, but those tools can no longer be called. OAuth scope: `api:write`. - [List MCP Server Tools](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/listMcpServerTools) Discover up to 1,000 tools within 5 MB, connect to the server, and update connection metadata. Results are unpaginated. Invalid OAuth returns `409` with `MCP_SERVER_REAUTHORIZATION_REQUIRED`; reauthorize through the browser. Unavailable servers return `503`. `HEAD` checks access with the same authorization as `GET` but skips side effects, returning an empty `200` without payload headers on success. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Workflow MCP Servers](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/listWorkflowMcpServers) List MCP servers that expose deployed workflows to external clients. Use List MCP Servers for external servers Agent Serve calls. Tool names share a 2,000-name page limit; inspect `toolNamesTruncated` and use List Workflow MCP Tools for a server's inventory. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Create Workflow MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/createWorkflowMcpServer) Create an MCP server that exposes deployed workflows as tools. Every supplied workflow must already be deployed. With `isPublic: true`, anyone with the server URL can execute its workflows without an Agent Serve API key. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Workflow MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/getWorkflowMcpServer) Get a published workflow MCP server's metadata and client endpoint. Use List Workflow MCP Tools for its tool inventory. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update Workflow MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/updateWorkflowMcpServer) Update a workflow MCP server's name, description, or public access. Omitted fields remain unchanged; `description: null` clears the description. Publish or unpublish tools separately. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Workflow MCP Server](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/deleteWorkflowMcpServer) Delete a workflow MCP server and stop serving its tools. The underlying workflows remain deployed and executable through the workflow API. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Workflow MCP Tools](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/listWorkflowMcpTools) List a server's published tools by name, including workflow IDs used to unpublish them. Returns up to 2,000 tools with `nextCursor: null`; `truncated` indicates an incomplete inventory that cannot be paginated. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Publish Workflow As MCP Tool](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/deployWorkflowMcpTool) Publish a deployed workflow as an MCP tool using its deployed input schema. Each server has at most one tool per workflow; repeating the call replaces that tool and returns `200` with `updated: true`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Unpublish Workflow MCP Tool](https://agentserve.valnoraelric.com/docs/api-reference/mcp-servers/undeployWorkflowMcpTool) Unpublish an MCP tool by its workflow ID. The workflow's API deployment remains active. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Skills](https://agentserve.valnoraelric.com/docs/api-reference/skills/listSkills) List workspace and built-in skills with cursor pagination. Built-in skills are read-only. The list omits skill bodies; use Get Skill to read content. OAuth scope: `api:read`. - [Create Skill](https://agentserve.valnoraelric.com/docs/api-reference/skills/createSkill) Create one skill in a workspace. Its kebab-case name must be unique and cannot be reserved by a built-in skill. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Skill](https://agentserve.valnoraelric.com/docs/api-reference/skills/getSkill) Get one workspace or built-in skill, including its full content. Built-in skills are marked read-only. OAuth scope: `api:read`. - [Update Skill](https://agentserve.valnoraelric.com/docs/api-reference/skills/updateSkill) Update a workspace skill. Omitted fields remain unchanged. Built-in skills are read-only. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Skill](https://agentserve.valnoraelric.com/docs/api-reference/skills/deleteSkill) Delete a workspace skill. Built-in skills are read-only and cannot be deleted. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Skill Editors](https://agentserve.valnoraelric.com/docs/api-reference/skills/listSkillEditors) List skill editors and workspace administrators with cursor pagination. OAuth scope: `api:read`. - [Grant Skill Editor](https://agentserve.valnoraelric.com/docs/api-reference/skills/grantSkillEditor) Grant skill editor access to a workspace member by email. Requires an existing editor or workspace admin; admins already have access and cannot receive explicit grants. Existing grants return `200`; new grants return `201`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Revoke Skill Editor](https://agentserve.valnoraelric.com/docs/api-reference/skills/revokeSkillEditor) Revoke an explicit editor grant by email. The caller must already be a skill editor or workspace administrator. Workspace administrators have derived access that cannot be revoked. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Custom Tools](https://agentserve.valnoraelric.com/docs/api-reference/custom-tools/listCustomTools) List code-backed custom tools in a workspace with cursor pagination. OAuth scope: `api:read`. - [Create Custom Tool](https://agentserve.valnoraelric.com/docs/api-reference/custom-tools/createCustomTool) Create a code-backed custom tool in a workspace. Its title must be unique because tools resolve by title at call time. OAuth scope: `api:write`. - [Get Custom Tool](https://agentserve.valnoraelric.com/docs/api-reference/custom-tools/getCustomTool) Get one custom tool by identifier, scoped to its workspace. OAuth scope: `api:read`. - [Update Custom Tool](https://agentserve.valnoraelric.com/docs/api-reference/custom-tools/updateCustomTool) Update a custom tool. Omitted fields remain unchanged; titles must remain unique within the workspace. OAuth scope: `api:write`. - [Delete Custom Tool](https://agentserve.valnoraelric.com/docs/api-reference/custom-tools/deleteCustomTool) Delete a custom tool. Agent blocks retain their configuration but can no longer call the deleted tool. OAuth scope: `api:write`. - [List Sandboxes](https://agentserve.valnoraelric.com/docs/api-reference/sandboxes/listSandboxes) List reusable dependency environments for Function blocks, including language packages, managed CLIs, and system packages. Sandboxes remain visible after a plan downgrade. OAuth scope: `api:read`. - [Create Sandbox](https://agentserve.valnoraelric.com/docs/api-reference/sandboxes/createSandbox) Create a uniquely named dependency environment. If a build is needed, track readiness with `buildStatus`; null means no build is required. Invalid dependencies return `400` with field details. Requires workspace admin access on Max or Enterprise. Creates and updates share a rate limit; respect `Retry-After`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get Sandbox](https://agentserve.valnoraelric.com/docs/api-reference/sandboxes/getSandbox) Get one sandbox by identifier, scoped to its workspace, including its current build state and any build failure. OAuth scope: `api:read`. - [Update Sandbox](https://agentserve.valnoraelric.com/docs/api-reference/sandboxes/updateSandbox) Update a sandbox, preserving omitted fields and replacing supplied lists. Dependency changes may start a build; resending a failed specification retries its build. `buildStatus: null` means no build is required. Requires workspace admin access on Max or Enterprise. Creates and updates share a rate limit; respect `Retry-After`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete Sandbox](https://agentserve.valnoraelric.com/docs/api-reference/sandboxes/deleteSandbox) Delete a sandbox. Function blocks using it fail until reconfigured. Requires workspace admin access on Max or Enterprise. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Credentials](https://agentserve.valnoraelric.com/docs/api-reference/credentials/listCredentials) List OAuth and service-account connections visible to the caller. Secret material is never returned. OAuth scope: `api:read`. - [Create Service-Account Credential](https://agentserve.valnoraelric.com/docs/api-reference/credentials/createServiceAccountCredential) Verify and store a service-account credential using the fields from List Credential Providers, encoded as a JSON object string in `credentials`. Secrets are never returned. A matching source returns the existing credential with `200`; creation returns `201`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Credential Providers](https://agentserve.valnoraelric.com/docs/api-reference/credentials/listCredentialProviders) List OAuth and service-account connection methods and their availability. OAuth options provide provider IDs for browser connections; service-account methods declare required fields and write-only secrets. Supports provider-name search. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Create Credential Connection](https://agentserve.valnoraelric.com/docs/api-reference/credentials/createCredentialConnection) Create a short-lived browser URL for connecting an OAuth provider or reconnecting an existing OAuth credential. Open the URL, sign in as the authenticated user, complete provider authorization, then refresh the credentials list. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Update Credential](https://agentserve.valnoraelric.com/docs/api-reference/credentials/updateCredential) Rename a service-account credential or rotate its secret fields, preserving omitted values and the credential ID. Requires credential admin access. Provider rejection preserves the old secret and returns `400` with `providerErrorCode`; outages return `503`. Fields for a different credential type return `400`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Disconnect Credential](https://agentserve.valnoraelric.com/docs/api-reference/credentials/deleteCredential) Disconnect an OAuth or service-account credential and clear its stored workflow, deployment, paused-run, knowledge-connector, and webhook references. Credential admin access is required. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Credential Members](https://agentserve.valnoraelric.com/docs/api-reference/credentials/listCredentialMembers) List explicit credential grants, including revoked grants, and inherited workspace administrator access. Requires workspace read access and the integrations.manage capability. Personal API keys and OAuth tokens can access OAuth or service-account credentials; sessions can also access workspace environment credentials. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Upsert Credential Member](https://agentserve.valnoraelric.com/docs/api-reference/credentials/upsertCredentialMember) Grant or change an existing workspace member’s credential role. Requires credential administrator access and the integrations.manage capability. Revoked grants become active again; inherited administrators cannot be demoted. A new grant returns 201; an existing grant returns 200. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Remove Credential Member](https://agentserve.valnoraelric.com/docs/api-reference/credentials/removeCredentialMember) Revoke an active explicit credential grant. Requires credential administrator access and the integrations.manage capability. Inherited workspace administrators cannot be removed; an absent or already-revoked grant returns 404. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Secrets](https://agentserve.valnoraelric.com/docs/api-reference/secrets/listSecrets) List workspace and caller-owned personal secrets with cursor pagination. Only workspace secrets marked `unredacted` include values; all other entries contain metadata only. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Delete Secret](https://agentserve.valnoraelric.com/docs/api-reference/secrets/deleteSecret) Delete a workspace or caller-owned personal secret without reading or returning its stored value. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Set Secret](https://agentserve.valnoraelric.com/docs/api-reference/secrets/setSecret) Create or replace a workspace or personal secret without returning its value. For existing workspace secrets, omit `value` to update metadata only; this returns `404` if absent. Personal secrets always require `value`. List Secrets can reveal workspace values marked `unredacted`. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get API Capabilities](https://agentserve.valnoraelric.com/docs/api-reference/meta/getApiMeta) Get whether v2 is available, what kind of API credential is calling, and when it expires. Requires a valid API key or OAuth access token. OAuth scope: `api:read`. - [List Blocks](https://agentserve.valnoraelric.com/docs/api-reference/catalog/listBlocks) List built-in and workspace-deployed blocks visible to the caller. Integration allowlists and preview visibility restrict results. Use `capability=trigger` for workflow starters and Get Block or Get Tool to resolve operation and tool IDs. OAuth scope: `api:read`. - [Get Block](https://agentserve.valnoraelric.com/docs/api-reference/catalog/getBlock) Get a block's fields, conditions, operations, tool schemas, and triggers. Unversioned types resolve to the newest visible version; the returned `id` identifies that version. Hidden or missing blocks return `404`. OAuth scope: `api:read`. - [List Tools](https://agentserve.valnoraelric.com/docs/api-reference/catalog/listTools) List built-in tools exposed by blocks visible to the caller. Use List MCP Server Tools for an external server's tools and List Custom Tools for workspace code-backed tools. OAuth scope: `api:read`. - [Get Tool](https://agentserve.valnoraelric.com/docs/api-reference/catalog/getTool) Get a built-in tool's parameters and outputs. Registered IDs resolve exactly; other names resolve to the newest family version. The returned `id` identifies the resolved tool. Hidden or missing tools return `404`. OAuth scope: `api:read`. - [Run Tool](https://agentserve.valnoraelric.com/docs/api-reference/catalog/executeTool) Run a built-in tool using published parameter IDs. Agent Serve resolves `credentialId`, hosted keys, and whole-value `{{VAR_NAME}}` references for `user-only` parameters; other values pass through verbatim. Third-party refusal returns `200` with `status: "failed"`; the error envelope covers API failures. Hidden or missing tools return `404`; disallowed integrations return `403` with `error.details.code: INTEGRATION_NOT_ALLOWED`. Hosted-key use is billed to the workspace. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Connector Types](https://agentserve.valnoraelric.com/docs/api-reference/catalog/listConnectorTypes) List connector types and accepted source configuration. A field with `multi: true` stores `string[]`. `canonicalParamId` links picker and manual fields that write the same key; send exactly one, keyed by `canonicalParamId` rather than its own `id`. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [List Apps](https://agentserve.valnoraelric.com/docs/api-reference/apps/listApps) List the apps this workspace can install — its organization's apps, or its own when it has no organization — with their latest and highest published versions. Requires write access and app building. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get App](https://agentserve.valnoraelric.com/docs/api-reference/apps/getApp) Get an app and every version, newest first. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Upload App Version](https://agentserve.valnoraelric.com/docs/api-reference/apps/uploadAppVersion) Upload a built bundle as a draft version. The manifest's `name` selects the app, creating it in this workspace when it is new; its `version` must not exist yet. Only static files (HTML, scripts, styles, data, images, fonts) may be in the bundle. The caller is authorized before the body is read. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Publish App Version](https://agentserve.valnoraelric.com/docs/api-reference/apps/publishAppVersion) Make a draft version installable. With `rollout`, this workspace's install moves to it. Requires workspace admin access in the workspace that manages the app. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Retire App Version](https://agentserve.valnoraelric.com/docs/api-reference/apps/retireAppVersion) Withdraw a version so it can no longer be installed or rolled back to. Refused with `409` while any workspace still runs it. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List App Installs](https://agentserve.valnoraelric.com/docs/api-reference/apps/listAppInstalls) List the apps installed in a workspace. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Install App](https://agentserve.valnoraelric.com/docs/api-reference/apps/installApp) Install a published version into a workspace. Tables the app requires that the workspace lacks are created first, under the caller's own table access; existing tables are left unchanged. Requires workspace admin access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Get App Install](https://agentserve.valnoraelric.com/docs/api-reference/apps/getAppInstall) Get one installed app with its pages, permissions, pins, and budget. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Update App Install](https://agentserve.valnoraelric.com/docs/api-reference/apps/updateAppInstall) Change the version a workspace runs (an upgrade or a roll back to another published version), who sees the app on their rail, its monthly budget, or whether it is on. Requires workspace admin access. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Uninstall App](https://agentserve.valnoraelric.com/docs/api-reference/apps/uninstallApp) Remove an app from a workspace. Tables it created and their data stay. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Delete App Secret](https://agentserve.valnoraelric.com/docs/api-reference/apps/deleteAppSecret) Delete an installed app's secret. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Set App Secret](https://agentserve.valnoraelric.com/docs/api-reference/apps/setAppSecret) Set a write-only secret for an installed app's server functions. The value is never returned and never reaches the app's browser frame. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List App Tools](https://agentserve.valnoraelric.com/docs/api-reference/apps/listAppTools) List the code tools the workspace's installed apps ship, at the version each install runs, with their input and output schemas. Requires read access and the Apps module. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Run App Tool](https://agentserve.valnoraelric.com/docs/api-reference/apps/runAppTool) Run an installed app's code tool in a sandbox with the app's secrets. Input and output are checked against the tool's schemas; a failed or slow run reports `failed` or `timed_out`. Runs count against the app's monthly budget. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List App Secrets](https://agentserve.valnoraelric.com/docs/api-reference/apps/listAppSecrets) List the names of an installed app's secrets and when each was set. Values are write-only and never returned. Requires admin access and app building. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get App Install Activity](https://agentserve.valnoraelric.com/docs/api-reference/apps/getAppInstallActivity) Get an installed app's spend this month against its budget, by usage source, its most recent audit entries, and the app's versions. Requires admin access and app building. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List App Repositories](https://agentserve.valnoraelric.com/docs/api-reference/apps/listAppRepos) List the Git repository an app deploys from — none or one. Repositories are connected and disconnected in the app's Manage page, with the person's own GitHub or GitLab access. Requires write access and app building in the workspace that manages the app. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [List App Deployments](https://agentserve.valnoraelric.com/docs/api-reference/apps/listAppDeployments) List an app's recent Git deployments, newest first — the last 50 builds of commits pushed to its repository. Returns the complete set in one page; `nextCursor` is always null. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Get App Deployment](https://agentserve.valnoraelric.com/docs/api-reference/apps/getAppDeployment) Get one Git deployment with the end of its build log. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Rebuild App Deployment](https://agentserve.valnoraelric.com/docs/api-reference/apps/rebuildAppDeployment) Build a failed deployment's commit again, as a new attempt of the same deployment. The build runs as the member who connected the repository. Refused with `409` unless the deployment failed and its repository is still connected. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Publish App Deployment](https://agentserve.valnoraelric.com/docs/api-reference/apps/publishAppDeployment) Publish a built deployment's draft version and move this workspace's install to it. Where the workspace requires a second admin to approve publishes, the first call records a request (`outcome: requested`) and a call by a different admin approves and publishes it. Requires workspace admin access in the workspace that manages the app. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Assign Relay Task](https://agentserve.valnoraelric.com/docs/api-reference/relays/assignRelayTask) Give a Relay a task, by the Relay's name, as yourself. This is the call an app makes with `assignRelayTask`. A Relay that is not published, is paused, or reached its daily task limit answers `409`. Requires write access and Relays. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [List Spaces](https://agentserve.valnoraelric.com/docs/api-reference/spaces/listSpaces) List the spaces you can read in a workspace — its team spaces and your personal space — with your role in each. Returns the complete set in one page; `nextCursor` is always null. A workspace API key reads team spaces only; personal spaces belong to one member. OAuth scope: `api:read`. - [List Space Docs](https://agentserve.valnoraelric.com/docs/api-reference/spaces/listSpaceDocs) List the docs in a space, outside the trash, in tree order. Returns the complete set in one page; `nextCursor` is always null. A workspace API key reads team spaces only; personal spaces belong to one member. OAuth scope: `api:read`. - [Get Space Doc](https://agentserve.valnoraelric.com/docs/api-reference/spaces/getSpaceDoc) Get a doc and its current content as markdown, as last saved — open editors save every few seconds. A workspace API key reads team spaces only; personal spaces belong to one member. OAuth scope: `api:read`. - [Start Presentation](https://agentserve.valnoraelric.com/docs/api-reference/slides/startPresentation) Create a deck in a space and have the Slides AI write it from `content` and the text of any `fileIds`. With `export`, the finished deck is also saved to the workspace Files. Writing takes up to a few minutes. The work runs asynchronously: poll Get Slides Job until its status is `succeeded` or `failed`. Requires permission to add docs to the space. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Export Presentation](https://agentserve.valnoraelric.com/docs/api-reference/slides/exportPresentation) Start exporting a deck as PowerPoint or PDF. The file is saved in the workspace Files; download it from the job's `result.export.downloadPath`. The work runs asynchronously: poll Get Slides Job until its status is `succeeded` or `failed`. Requires read access to the deck and write access to the workspace. A workspace API key exports decks in team spaces only. OAuth scope: `api:write`. - [Get Slides Job](https://agentserve.valnoraelric.com/docs/api-reference/slides/getSlidesJob) Get the status of a job you started, with the deck and any exported file once it succeeds. Jobs started by someone else read as not found. A job interrupted by a server restart reads as `failed`; start it again. OAuth scope: `api:read`. - [List Slides Templates](https://agentserve.valnoraelric.com/docs/api-reference/slides/listSlidesTemplates) List the built-in templates decks can be laid out with. Returns the complete set in one page; `nextCursor` is always null. OAuth scope: `api:read`. - [Get Semantic Model](https://agentserve.valnoraelric.com/docs/api-reference/semantic-model/getSemanticModel) Get the workspace semantic model as `agentserve.model.yaml` holds it: the published model, or with `source=draft` the caller’s own draft. Drafts, versions and diffs are available while model drafts are turned on for the deployment; otherwise these operations answer 404. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Query Semantic Model](https://agentserve.valnoraelric.com/docs/api-reference/semantic-model/querySemanticModel) Query the semantic model by name: measures grouped by dimensions, with filters, a sort and a limit. This is the query an app makes with `queryModel`. Every table it reads is checked against your own access. Without `source`, it uses your draft while draft mode is on. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. - [Push Semantic Model Draft](https://agentserve.valnoraelric.com/docs/api-reference/semantic-model/pushSemanticModelDraft) Replace the caller’s semantic model draft with the given model (an object or `agentserve.model.yaml` text), starting a draft when none is open. Never publishes. A draft waiting for approval cannot change. Drafts, versions and diffs are available while model drafts are turned on for the deployment; otherwise these operations answer 404. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:write`. - [Diff Semantic Model](https://agentserve.valnoraelric.com/docs/api-reference/semantic-model/diffSemanticModel) Compare the given model with the published model, or with `against=draft` the caller’s draft: entities added, removed or changed, and inside each changed entity its attributes, measures and relationships, plus conformed dimensions, calendars and calculation groups. Drafts, versions and diffs are available while model drafts are turned on for the deployment; otherwise these operations answer 404. Workspace API keys return `403`; use a personal API key or scoped OAuth token. OAuth scope: `api:read`. ### Apps - [Apps](https://agentserve.valnoraelric.com/docs/apps) Find, install, and open the apps your team runs inside the workspace. - [Manage an app](https://agentserve.valnoraelric.com/docs/apps/manage) Turn an app on or off, set its budget and rail placement, review its access, switch versions, and uninstall it. ### Chat - [Files & documents](https://agentserve.valnoraelric.com/docs/chat/files) Upload, create, edit, and generate files — documents, presentations, images, and more. - [Chat](https://agentserve.valnoraelric.com/docs/chat) Your AI command center. Talk to Agent Serve — build and manage everything in natural language. - [Knowledge bases](https://agentserve.valnoraelric.com/docs/chat/knowledge) Create, populate, and query knowledge bases from Chat. - [Agent Serve Mailer](https://agentserve.valnoraelric.com/docs/chat/mailer) Send emails to your workspace and let Agent Serve handle them as tasks. - [Research](https://agentserve.valnoraelric.com/docs/chat/research) Ask Agent Serve to research anything — it searches, reads, and synthesizes from the web. - [Tables](https://agentserve.valnoraelric.com/docs/chat/tables) Create, query, and manage workspace tables from Chat. - [Automation & configuration](https://agentserve.valnoraelric.com/docs/chat/tasks) Schedule recurring jobs, take immediate actions, connect integrations, and configure your workspace. - [Workflows](https://agentserve.valnoraelric.com/docs/chat/workflows) Create, edit, run, debug, deploy, and organize workflows from Chat. ### Dashboards - [AI in dashboards](https://agentserve.valnoraelric.com/docs/dashboards/ai) Generate panels from a description, change a panel in plain words, explain a chart, and ask questions about a dashboard. - [Formulas and calculations](https://agentserve.valnoraelric.com/docs/dashboards/calculations) Add dashboard formulas, calculated fields, period comparisons, and combine data from several sources in one panel. - [Call Compliance](https://agentserve.valnoraelric.com/docs/dashboards/call-compliance) Upload call transcripts into a dashboard panel, configure compliance checks, test them, and read a per-call compliance report. - [Exploring dashboards](https://agentserve.valnoraelric.com/docs/dashboards/exploring) Drill into charts, see the rows behind a number, save bookmarks, annotate, and explore a personal version. - [Filters and parameters](https://agentserve.valnoraelric.com/docs/dashboards/filters-and-parameters) Let viewers slice a dashboard with filters, and drive calculations with parameters. - [Row security and version history](https://agentserve.valnoraelric.com/docs/dashboards/governance) Control which rows each person sees, and review or restore earlier versions of a dashboard. - [Dashboards](https://agentserve.valnoraelric.com/docs/dashboards) Build dashboards on your data — charts, KPIs, tables, pivots, and maps — then explore, share, and govern them. - [Panels](https://agentserve.valnoraelric.com/docs/dashboards/panels) The panel types you can add to a dashboard, and the inspector tabs that configure them. - [Scenario models](https://agentserve.valnoraelric.com/docs/dashboards/scenarios) What-if dashboards that let viewers change assumptions and compare scenarios, such as the Deal Simulator. - [Sharing and reports](https://agentserve.valnoraelric.com/docs/dashboards/sharing-and-reports) Share dashboards and public viewer links, export PDF, PNG, and CSV, schedule reports, set KPI alerts, and certify trusted dashboards. - [Themes](https://agentserve.valnoraelric.com/docs/dashboards/themes) Change a dashboard's palette, colours, cards, spacing, and number style, in light and dark. ### Desktop - [Agent Serve Desktop](https://agentserve.valnoraelric.com/docs/desktop) Install the macOS app — Agent Serve in its own window, with a built-in browser, a terminal, and access to local folders. ### Data - [Data sources](https://agentserve.valnoraelric.com/docs/data/data-sources) Connect warehouses, databases, apps, and spreadsheets, and sync datasets from them on a schedule or live. - [Data](https://agentserve.valnoraelric.com/docs/data) Connect your data, then define metrics, relationships, and business rules once so every dashboard, agent, and Relay uses the same numbers. - [Metrics](https://agentserve.valnoraelric.com/docs/data/metrics) Define a number once — revenue, churn, conversion — and use the same definition in every dashboard, agent, and Relay. - [Monitors and alerts](https://agentserve.valnoraelric.com/docs/data/monitors) Watch metrics and rules on a schedule and get alerted when they cross a threshold. - [Rules](https://agentserve.valnoraelric.com/docs/data/rules) Reusable business logic that flags, classifies, or scores records. - [Semantic model](https://agentserve.valnoraelric.com/docs/data/semantic-model) Describe your business entities, how your tables join, and the words people use for them, so dashboards and AI answer consistently. - [Workbooks](https://agentserve.valnoraelric.com/docs/data/workbooks) Write and run SQL against your data sources in cells, get AI help with queries, chart the results, and save them as datasets or dashboard panels. ### Developers - [agentserve app](https://agentserve.valnoraelric.com/docs/developers/cli) The CLI commands for creating, running, deploying, publishing and operating apps. - [Code tools](https://agentserve.valnoraelric.com/docs/developers/code-tools) Ship functions with your app that run on Agent Serve and give the same answer every time, for the app, Chat, Relays and workflows. - [Deploying from Git](https://agentserve.valnoraelric.com/docs/developers/git-deploys) Connect a GitHub or GitLab repository so every push builds a draft version, with branch rules, publish approvals and a dependency audit. - [Browser IDE](https://agentserve.valnoraelric.com/docs/developers/ide) Edit an app in VS Code for the web with a live preview, commit and push to its repository, and review code changes Chat proposes. A preview feature. - [Build on Agent Serve](https://agentserve.valnoraelric.com/docs/developers) Build small web apps that run inside an Agent Serve workspace and use its people, data, workflows, Relays and Chat. - [Manifest reference](https://agentserve.valnoraelric.com/docs/developers/manifest) Every field of agentserve.app.yaml — pages, permissions, required tables, rules and Relays, panels, Chat cards, budget, and the plugin sections. - [Plugins](https://agentserve.valnoraelric.com/docs/developers/plugins) Apps that add Chat commands, menu items, background triggers, settings, connectors and skills to the whole workspace — with one manifest, one install review and one security model. - [Quickstart](https://agentserve.valnoraelric.com/docs/developers/quickstart) Create an app from a template, run it against your workspace, then deploy, publish and install it. - [App SDK](https://agentserve.valnoraelric.com/docs/developers/sdk) The @agentserve/app-sdk reference — the client, React hooks, results, errors, limits, theme and resize, and the plugin methods and handler types. - [Security model](https://agentserve.valnoraelric.com/docs/developers/security) How an app acts as the person using it, how the sandboxed frame isolates it, what admins approve, and how budgets, secrets and audit work. - [Templates](https://agentserve.valnoraelric.com/docs/developers/templates) Seven starting points for an app and two complete example apps — what each one does, who it is for, and what it asks for. ### Cli - [App](https://agentserve.valnoraelric.com/docs/cli/app) Build, run and ship apps that run inside a workspace (agentserve.app.yaml) (OAuth login or personal API key required) — every subcommand, argument, and flag - [Apps](https://agentserve.valnoraelric.com/docs/cli/apps) Manage apps — every subcommand, argument, and flag - [Audit Logs](https://agentserve.valnoraelric.com/docs/cli/audit-logs) Manage audit logs — every subcommand, argument, and flag - [Authentication](https://agentserve.valnoraelric.com/docs/cli/authentication) Sign in from the terminal, authenticate CI with an API key, and keep several accounts side by side - [Billing](https://agentserve.valnoraelric.com/docs/cli/billing) Manage billing — every subcommand, argument, and flag - [Blocks](https://agentserve.valnoraelric.com/docs/cli/blocks) Manage blocks — every subcommand, argument, and flag - [Chat Deployments](https://agentserve.valnoraelric.com/docs/cli/chat-deployments) Manage chat deployments — every subcommand, argument, and flag - [CLI](https://agentserve.valnoraelric.com/docs/cli/cli) Discover commands in this CLI — every subcommand, argument, and flag - [CLI Commands](https://agentserve.valnoraelric.com/docs/cli/commands) Global options, and every agentserve command group - [Configuration](https://agentserve.valnoraelric.com/docs/cli/configuration) Profiles, config files, environment variables, and how each setting is resolved - [Connector Types](https://agentserve.valnoraelric.com/docs/cli/connector-types) Manage connector types — every subcommand, argument, and flag - [Credentials](https://agentserve.valnoraelric.com/docs/cli/credentials) Manage credentials — every subcommand, argument, and flag - [Custom Tools](https://agentserve.valnoraelric.com/docs/cli/custom-tools) Manage custom tools — every subcommand, argument, and flag - [Files](https://agentserve.valnoraelric.com/docs/cli/files) Manage files — every subcommand, argument, and flag - [Agent Serve CLI](https://agentserve.valnoraelric.com/docs/cli) Drive workflows, tables, files, knowledge bases, and logs from your shell - [Knowledge](https://agentserve.valnoraelric.com/docs/cli/knowledge) Manage knowledge — every subcommand, argument, and flag - [Logs](https://agentserve.valnoraelric.com/docs/cli/logs) Manage logs — every subcommand, argument, and flag - [MCP Servers](https://agentserve.valnoraelric.com/docs/cli/mcp-servers) Manage mcp servers — every subcommand, argument, and flag - [Meta](https://agentserve.valnoraelric.com/docs/cli/meta) Manage meta — every subcommand, argument, and flag - [Model](https://agentserve.valnoraelric.com/docs/cli/model) Work with the semantic model as code (agentserve.model.yaml) — every subcommand, argument, and flag - [Organizations](https://agentserve.valnoraelric.com/docs/cli/organizations) Manage organizations — every subcommand, argument, and flag - [Output formats](https://agentserve.valnoraelric.com/docs/cli/output) table, json, yaml, and text — what each is for, and how to select one - [Permission Groups](https://agentserve.valnoraelric.com/docs/cli/permission-groups) Manage permission groups — every subcommand, argument, and flag - [Profiles](https://agentserve.valnoraelric.com/docs/cli/profiles) List profiles or add a workspace profile that shares a stored login — every subcommand, argument, and flag - [Complete reference](https://agentserve.valnoraelric.com/docs/cli/reference) Every agentserve command, argument, and flag on a single page - [Relays](https://agentserve.valnoraelric.com/docs/cli/relays) Manage relays — every subcommand, argument, and flag - [Runner](https://agentserve.valnoraelric.com/docs/cli/runner) Run Agent Serve jobs on this machine (link, run, status, unlink) — every subcommand, argument, and flag - [Sandboxes](https://agentserve.valnoraelric.com/docs/cli/sandboxes) Manage sandboxes — every subcommand, argument, and flag - [Scripting](https://agentserve.valnoraelric.com/docs/cli/scripting) File and stdin inputs, list flags, pagination, exit codes, and automation recipes - [Secrets](https://agentserve.valnoraelric.com/docs/cli/secrets) Manage secrets — every subcommand, argument, and flag - [Selectors](https://agentserve.valnoraelric.com/docs/cli/selectors) Manage selectors — every subcommand, argument, and flag - [Semantic Model](https://agentserve.valnoraelric.com/docs/cli/semantic-model) Manage semantic model — every subcommand, argument, and flag - [Skills](https://agentserve.valnoraelric.com/docs/cli/skills) Manage skills — every subcommand, argument, and flag - [Slides](https://agentserve.valnoraelric.com/docs/cli/slides) Manage slides — every subcommand, argument, and flag - [Spaces](https://agentserve.valnoraelric.com/docs/cli/spaces) Manage spaces — every subcommand, argument, and flag - [Tables](https://agentserve.valnoraelric.com/docs/cli/tables) Manage tables — every subcommand, argument, and flag - [Telemetry](https://agentserve.valnoraelric.com/docs/cli/telemetry) Control anonymous usage reporting — every subcommand, argument, and flag - [Tools](https://agentserve.valnoraelric.com/docs/cli/tools) Manage tools — every subcommand, argument, and flag - [Troubleshooting](https://agentserve.valnoraelric.com/docs/cli/troubleshooting) The failures whose cause is not obvious from the error message - [Usage data](https://agentserve.valnoraelric.com/docs/cli/usage-data) What the CLI reports about how it is used, what it never sends, and how to turn reporting off - [Workflow MCP Servers](https://agentserve.valnoraelric.com/docs/cli/workflow-mcp-servers) Manage workflow mcp servers — every subcommand, argument, and flag - [Workflow imports and workspace sync](https://agentserve.valnoraelric.com/docs/cli/workflow-sync) Preview resource bindings, apply reviewed changes, and verify readiness from an LLM or CI client - [Workflows](https://agentserve.valnoraelric.com/docs/cli/workflows) Manage workflows — every subcommand, argument, and flag - [Workspaces](https://agentserve.valnoraelric.com/docs/cli/workspaces) Manage workspaces — every subcommand, argument, and flag ### Files - [Editor](https://agentserve.valnoraelric.com/docs/files/editor) A rich markdown editor for your files — type markdown and watch it render, or edit visually. - [Generating files](https://agentserve.valnoraelric.com/docs/files/generating) How a workflow produces a document, report, or media file and saves it to the workspace Files store. - [Library](https://agentserve.valnoraelric.com/docs/files) The Library holds the documents, images, spreadsheets, and PDFs your team, workflows, and Relays read and produce. - [Passing files](https://agentserve.valnoraelric.com/docs/files/passing-files) How file objects move between blocks, into workflows via the API, and back out in responses. - [Using files in workflows](https://agentserve.valnoraelric.com/docs/files/using-in-workflows) Read a file's contents in a workflow, pass a file to a block that needs one, or save a new file from a run. ### Getting Started - [Getting Started](https://agentserve.valnoraelric.com/docs/getting-started) Build your first agent in 10 minutes — a people researcher with web search tools and structured output. ### Introduction - [Introduction](https://agentserve.valnoraelric.com/docs/introduction) Agent Serve is the AI workspace where teams build, deploy, and manage AI agents. ### Keyboard Shortcuts - [Keyboard Shortcuts](https://agentserve.valnoraelric.com/docs/keyboard-shortcuts) Keyboard and mouse shortcuts for the workflow editor and for tables. ### Logs Debugging - [Alerts](https://agentserve.valnoraelric.com/docs/logs-debugging/alerts) Send an alert when a watched workflow fails or exceeds an operational threshold. - [Logs](https://agentserve.valnoraelric.com/docs/logs-debugging) A log is the recorded trace of one workflow run, and debugging is reading that trace backward from the block that failed. - [Logging](https://agentserve.valnoraelric.com/docs/logs-debugging/logging) Where run logs live — the real-time console, the Logs page, and what each entry records. ### Knowledgebase - [Chunking strategies](https://agentserve.valnoraelric.com/docs/knowledgebase/chunking-strategies) The chunking settings and strategies, for the rare case you need to override Auto. - [Connectors](https://agentserve.valnoraelric.com/docs/knowledgebase/connectors) Automatically sync documents from external sources into your knowledge base - [Debugging retrieval](https://agentserve.valnoraelric.com/docs/knowledgebase/debugging-retrieval) Why a Knowledge block search returns no results, wrong results, or duplicates, and how to fix each one. - [Export](https://agentserve.valnoraelric.com/docs/knowledgebase/export-import) Download a knowledge base as one archive of its documents, chunks, tags, and settings. - [Knowledge Base](https://agentserve.valnoraelric.com/docs/knowledgebase) A store of documents your agents can search by meaning. - [Tags and filtering](https://agentserve.valnoraelric.com/docs/knowledgebase/tags) - [Using a knowledge base in a workflow](https://agentserve.valnoraelric.com/docs/knowledgebase/using-in-workflows) How the Knowledge block searches a knowledge base and what it returns, so an agent can ground its answers in your documents. ### Mcp - [Authentication](https://agentserve.valnoraelric.com/docs/mcp/authentication) Sign in with OAuth, or connect with an API key - [Agent Serve MCP](https://agentserve.valnoraelric.com/docs/mcp) Build, run, and manage everything in your Agent Serve workspace from Claude, Codex, Cursor, and other MCP apps - [Tools](https://agentserve.valnoraelric.com/docs/mcp/tools) How an agent finds, reads, and calls Agent Serve operations through four tools ### Platform - [Connected accounts](https://agentserve.valnoraelric.com/docs/platform/connected-accounts) Collect accounts in one organization credential group and control which workspaces can use them. - [Cost calculation](https://agentserve.valnoraelric.com/docs/platform/costs) - [Secrets](https://agentserve.valnoraelric.com/docs/platform/credentials) Manage API keys and environment variables for your workflows - [Organizing a workspace](https://agentserve.valnoraelric.com/docs/platform/organization) Folders, colors, and naming conventions for keeping a growing workspace understandable. - [Roles and permissions](https://agentserve.valnoraelric.com/docs/platform/permissions) How organization, workspace, and credential roles work together — and how they inherit. - [Settings](https://agentserve.valnoraelric.com/docs/platform/settings) Where each setting lives — account, team space, tools, organization, governance, and system. - [Workspace fundamentals](https://agentserve.valnoraelric.com/docs/platform/workspaces) A workspace holds your workflows and resources and decides who can access them. - [Access Control](https://agentserve.valnoraelric.com/docs/platform/enterprise/access-control) Restrict which models, blocks, and platform features each group of users can access - [Audit Logs](https://agentserve.valnoraelric.com/docs/platform/enterprise/audit-logs) Track every action taken across your organization's workspaces - [Custom Blocks](https://agentserve.valnoraelric.com/docs/platform/enterprise/custom-blocks) Publish a deployed workflow as a reusable block for your organization - [Data Drains](https://agentserve.valnoraelric.com/docs/platform/enterprise/data-drains) Continuously export workflow logs, audit logs, and Chat data to your own object store, data warehouse, observability platform, or HTTPS endpoint on a schedule - [Data Retention](https://agentserve.valnoraelric.com/docs/platform/enterprise/data-retention) Control how long execution logs, deleted resources, and Chat data are kept before permanent deletion — and redact PII from workflow data - [Workspace Forks](https://agentserve.valnoraelric.com/docs/platform/enterprise/forks) Clone a workspace, keep it linked to its parent, and push or pull deployed workflow changes - [Enterprise](https://agentserve.valnoraelric.com/docs/platform/enterprise) Enterprise features for business organizations - [Security](https://agentserve.valnoraelric.com/docs/platform/enterprise/security) Manage organization session policies and view configured outbound IP addresses - [Self-hosted Enterprise](https://agentserve.valnoraelric.com/docs/platform/enterprise/self-hosted) Run the full enterprise feature set on a self-hosted deployment without billing - [Session Policies](https://agentserve.valnoraelric.com/docs/platform/enterprise/session-policies) Set session lifetime limits and sign out every member of your organization at once - [Single Sign-On (SSO)](https://agentserve.valnoraelric.com/docs/platform/enterprise/sso) Configure SAML 2.0 or OIDC-based single sign-on for your organization - [Insights](https://agentserve.valnoraelric.com/docs/platform/enterprise/usage-tracking) Explore organization credit usage, workflow performance, and recorded chat activity - [Verified Domains](https://agentserve.valnoraelric.com/docs/platform/enterprise/verified-domains) Prove ownership of your email domains for single sign-on and directory provisioning - [White-labeling](https://agentserve.valnoraelric.com/docs/platform/enterprise/whitelabeling) Replace Agent Serve branding with your own logo, colors, and links - [Architecture](https://agentserve.valnoraelric.com/docs/platform/self-hosting/architecture) Every service Agent Serve runs, what it depends on, and where state lives - [Authentication](https://agentserve.valnoraelric.com/docs/platform/self-hosting/authentication) Login providers, SSO, and controlling who can sign up - [Background Jobs](https://agentserve.valnoraelric.com/docs/platform/self-hosting/background-jobs) Scheduled workflows, polling triggers, and the cron endpoints that drive them - [Desktop App on Your Deployment](https://agentserve.valnoraelric.com/docs/platform/self-hosting/desktop) Point the macOS desktop app at your own Agent Serve deployment - [Docker](https://agentserve.valnoraelric.com/docs/platform/self-hosting/docker) Deploy Agent Serve with Docker Compose - [Email](https://agentserve.valnoraelric.com/docs/platform/self-hosting/email) Configure transactional email for invitations, verification, and notifications - [Environment Variables](https://agentserve.valnoraelric.com/docs/platform/self-hosting/environment-variables) Configuration reference for Agent Serve - [Self-Hosting](https://agentserve.valnoraelric.com/docs/platform/self-hosting) Deploy Agent Serve on your own infrastructure - [Integrations & OAuth](https://agentserve.valnoraelric.com/docs/platform/self-hosting/integrations-oauth) Register OAuth apps so your users can connect Slack, Google, Jira, and every other integration - [Kubernetes](https://agentserve.valnoraelric.com/docs/platform/self-hosting/kubernetes) Deploy Agent Serve with Helm - [Networking](https://agentserve.valnoraelric.com/docs/platform/self-hosting/networking) Reverse proxies, TLS, websockets, timeouts, and request size limits - [Object Storage](https://agentserve.valnoraelric.com/docs/platform/self-hosting/object-storage) Configure where Agent Serve stores uploaded files — local disk, AWS S3, Azure Blob, or Google Cloud Storage - [Observability](https://agentserve.valnoraelric.com/docs/platform/self-hosting/observability) Health checks, logs, tracing, and what to alert on - [Cloud Platforms](https://agentserve.valnoraelric.com/docs/platform/self-hosting/platforms) Provider-specific notes for running Agent Serve on Railway, a VPS, or managed Kubernetes - [Redis](https://agentserve.valnoraelric.com/docs/platform/self-hosting/redis) When Redis is optional, when it is required, and how to configure it - [Reference Architectures](https://agentserve.valnoraelric.com/docs/platform/self-hosting/reference-architectures) What you provision and what the chart provisions, per cloud, before you run helm install - [Sandboxes](https://agentserve.valnoraelric.com/docs/platform/self-hosting/sandboxes) Configure the remote execution provider and Function base image that Python, Shell, and imported JavaScript run on - [Scaling & High Availability](https://agentserve.valnoraelric.com/docs/platform/self-hosting/scaling) Replicas, connection pooling, autoscaling, and where the limits actually are - [Security & Hardening](https://agentserve.valnoraelric.com/docs/platform/self-hosting/security) Secrets, network boundaries, code sandboxing, and the settings to review before going live - [Troubleshooting](https://agentserve.valnoraelric.com/docs/platform/self-hosting/troubleshooting) Common issues and solutions - [Upgrades](https://agentserve.valnoraelric.com/docs/platform/self-hosting/upgrades) Pinning versions, running migrations safely, and rolling back - [Verify Your Install](https://agentserve.valnoraelric.com/docs/platform/self-hosting/verify) Smoke-test the app, authentication, workflows, storage, and scheduled jobs - [Microsoft Entra provisioning](https://agentserve.valnoraelric.com/docs/platform/enterprise/scim/entra) Connect Microsoft Entra ID to Agent Serve and verify user and group provisioning - [Directory provisioning (SCIM)](https://agentserve.valnoraelric.com/docs/platform/enterprise/scim) Create, update, and deactivate Agent Serve members automatically from your identity provider - [Okta provisioning](https://agentserve.valnoraelric.com/docs/platform/enterprise/scim/okta) Connect a private Okta SCIM integration to Agent Serve and verify user and group provisioning ### Quick Reference - [Quick Reference](https://agentserve.valnoraelric.com/docs/quick-reference) Essential actions for navigating and using the Agent Serve workflow builder ### Plugins - [Discover](https://agentserve.valnoraelric.com/docs/plugins/discover) Browse plugins by team or category, read what each one adds, and connect tools from the connectors directory. - [Agent Serve plugins](https://agentserve.valnoraelric.com/docs/plugins/first-party) The seven plugins Agent Serve publishes — what each one does, its commands and menu actions, and what it needs. - [Plugins](https://agentserve.valnoraelric.com/docs/plugins) Add Chat commands, menu actions, background work, connectors, and skills to your workspace in one install. - [Install a plugin](https://agentserve.valnoraelric.com/docs/plugins/install) What the install review shows — access, resource slots, settings, Relays, and background approval — and what happens when you click Install. - [Manage plugins](https://agentserve.valnoraelric.com/docs/plugins/manage) Change a plugin's resources and settings, approve or pause background runs, see every run, set caps, and choose who can use its connectors. - [Use plugins](https://agentserve.valnoraelric.com/docs/plugins/use) Run plugins from Chat with slash commands, from menus on files, table rows, queries, and dashboard panels, or let their triggers run on their own. ### Relays - [Charter and rules](https://agentserve.valnoraelric.com/docs/relays/charter-and-rules) See a Relay's role, cadence, autonomy, and rules on one page, accept rules suggested from your approval history, and set goals. - [Email and calendar](https://agentserve.valnoraelric.com/docs/relays/email-and-calendar) How a Relay sends email with attachments and books, moves, or cancels meetings — always after a person approves the exact action. - [Browser and computer](https://agentserve.valnoraelric.com/docs/relays/equipment) Give a Relay its own browser or an isolated cloud computer, limit where it can go, and take over control at any time. - [Relays](https://agentserve.valnoraelric.com/docs/relays) Relays are AI teammates. Give one a role, the data and tools it may use, and the actions it must ask about, then hand it jobs and get finished work back. - [Knowledge and data](https://agentserve.valnoraelric.com/docs/relays/knowledge) What a Relay can read — connected data, file knowledge, and the access rules it follows. - [Routines and skills](https://agentserve.valnoraelric.com/docs/relays/routines) Give a Relay recurring work, teach it a routine by doing it once on its browser, and write the skills it follows. - [Safety and accountability](https://agentserve.valnoraelric.com/docs/relays/safety) How Relays act on behalf of a person, never pass as one, and leave a full audit trail. - [Set up a Relay](https://agentserve.valnoraelric.com/docs/relays/setup) The six setup steps — Basics, How it works, What it can use, Ongoing work, Permissions, and Review & publish. - [Jobs and approvals](https://agentserve.valnoraelric.com/docs/relays/tasks-and-approvals) Chat with a Relay, assign it jobs, follow job states, and approve or decline the exact actions it proposes — after auto-review checks them. - [Work, Live, and Outputs](https://agentserve.valnoraelric.com/docs/relays/work-and-outputs) Follow a Relay's jobs in lanes, watch what it is doing right now, and see every deliverable it handed back. ### Integrations - [A2A](https://agentserve.valnoraelric.com/docs/integrations/a2a) Interact with external A2A-compatible agents - [Affinity](https://agentserve.valnoraelric.com/docs/integrations/affinity) Read and write companies, people, lists, notes, and relationships in Affinity - [AgentMail](https://agentserve.valnoraelric.com/docs/integrations/agentmail) Manage email inboxes, threads, and messages with AgentMail - [AgentPhone](https://agentserve.valnoraelric.com/docs/integrations/agentphone) Provision numbers, send SMS and iMessage, and place voice calls with AgentPhone - [Agiloft](https://agentserve.valnoraelric.com/docs/integrations/agiloft) Manage records in Agiloft CLM - [Ahrefs](https://agentserve.valnoraelric.com/docs/integrations/ahrefs) SEO analysis with Ahrefs - [Aircall](https://agentserve.valnoraelric.com/docs/integrations/aircall) Start, transfer, log, and review sales and support calls in Aircall - [Airtable Personal Access Tokens](https://agentserve.valnoraelric.com/docs/integrations/airtable-service-account) Set up an Airtable personal access token with scoped base access to use Airtable in Agent Serve workflows - [Airtable](https://agentserve.valnoraelric.com/docs/integrations/airtable) Read, create, and update Airtable - [Airweave](https://agentserve.valnoraelric.com/docs/integrations/airweave) Search your synced data collections - [Algolia](https://agentserve.valnoraelric.com/docs/integrations/algolia) Search and manage Algolia indices - [Amplitude](https://agentserve.valnoraelric.com/docs/integrations/amplitude) Track events and query analytics from Amplitude - [Apify](https://agentserve.valnoraelric.com/docs/integrations/apify) Run Apify actors and retrieve results - [Apollo](https://agentserve.valnoraelric.com/docs/integrations/apollo) Search, enrich, and manage contacts with Apollo.io - [AWS AppConfig](https://agentserve.valnoraelric.com/docs/integrations/appconfig) Manage and retrieve configuration with AWS AppConfig - [ArXiv](https://agentserve.valnoraelric.com/docs/integrations/arxiv) Search and retrieve academic papers from ArXiv - [Asana Service Accounts & Personal Access Tokens](https://agentserve.valnoraelric.com/docs/integrations/asana-service-account) Connect Asana to Agent Serve with a service account token or a personal access token from a dedicated bot account - [Asana](https://agentserve.valnoraelric.com/docs/integrations/asana) Interact with Asana - [Ashby](https://agentserve.valnoraelric.com/docs/integrations/ashby) Manage candidates, jobs, and applications in Ashby - [Athena](https://agentserve.valnoraelric.com/docs/integrations/athena) Run SQL queries on data in Amazon S3 using AWS Athena - [Atlassian Service Accounts](https://agentserve.valnoraelric.com/docs/integrations/atlassian-service-account) Connect Jira, Jira Service Management, and Confluence workflows with a scoped service-account API token - [Attio API Keys](https://agentserve.valnoraelric.com/docs/integrations/attio-service-account) Connect Attio to Agent Serve with a workspace API key — a workspace-level, non-expiring access token with admin-chosen scopes - [Attio](https://agentserve.valnoraelric.com/docs/integrations/attio) Manage records, notes, tasks, lists, comments, and more in Attio CRM - [Azure Data Explorer](https://agentserve.valnoraelric.com/docs/integrations/azure_data_explorer) Query and manage Azure Data Explorer (Kusto) clusters with KQL - [Azure DevOps](https://agentserve.valnoraelric.com/docs/integrations/azure_devops) Interact with Azure DevOps pipelines, builds, and work items - [Bitbucket](https://agentserve.valnoraelric.com/docs/integrations/bitbucket) Work with Bitbucket Cloud repositories, pull requests, and pipelines - [Bolna](https://agentserve.valnoraelric.com/docs/integrations/bolna) Place voice AI phone calls and read their transcripts with Bolna - [Box Service Accounts](https://agentserve.valnoraelric.com/docs/integrations/box-service-account) Set up a Box Platform app with Client Credentials Grant so your workflows can use Box through its Service Account - [Box](https://agentserve.valnoraelric.com/docs/integrations/box) Manage files, folders, and e-signatures with Box - [Brandfetch](https://agentserve.valnoraelric.com/docs/integrations/brandfetch) Look up brand assets, logos, colors, and company info - [Brevo](https://agentserve.valnoraelric.com/docs/integrations/brevo) Send email, SMS, and WhatsApp, and manage contacts and campaigns in Brevo - [Brex](https://agentserve.valnoraelric.com/docs/integrations/brex) Manage expenses, receipts, transactions, and team data in Brex - [Bright Data](https://agentserve.valnoraelric.com/docs/integrations/brightdata) Scrape websites, search engines, and extract structured data - [Browser Use](https://agentserve.valnoraelric.com/docs/integrations/browser_use) Run browser automation tasks - [Buffer](https://agentserve.valnoraelric.com/docs/integrations/buffer) Schedule and publish social media posts across connected channels - [Cal.com API Keys](https://agentserve.valnoraelric.com/docs/integrations/calcom-service-account) Set up a Cal.com API key to use Cal.com in Agent Serve workflows without OAuth - [Cal.com](https://agentserve.valnoraelric.com/docs/integrations/calcom) Manage Cal.com bookings, event types, schedules, and availability - [Calendly](https://agentserve.valnoraelric.com/docs/integrations/calendly) Manage Calendly scheduling and events - [CB Insights](https://agentserve.valnoraelric.com/docs/integrations/cbinsights) Research private markets — firmographics, funding, and predictive scores - [Checkr](https://agentserve.valnoraelric.com/docs/integrations/checkr) Run and manage background checks with Checkr - [Circleback](https://agentserve.valnoraelric.com/docs/integrations/circleback) AI-powered meeting notes, action items, and transcripts - [Clay](https://agentserve.valnoraelric.com/docs/integrations/clay) Populate Clay workbook - [Clerk](https://agentserve.valnoraelric.com/docs/integrations/clerk) Manage users, organizations, and sessions in Clerk - [ClickHouse](https://agentserve.valnoraelric.com/docs/integrations/clickhouse) Connect to a ClickHouse database - [ClickUp API Tokens](https://agentserve.valnoraelric.com/docs/integrations/clickup-service-account) Connect ClickUp to Agent Serve with a personal API token — ideally created from a dedicated service user for production workflows - [ClickUp](https://agentserve.valnoraelric.com/docs/integrations/clickup) Interact with ClickUp - [Cloudflare](https://agentserve.valnoraelric.com/docs/integrations/cloudflare) Manage DNS, WAF, Zero Trust access, and edge infrastructure - [CloudFormation](https://agentserve.valnoraelric.com/docs/integrations/cloudformation) Manage and inspect AWS CloudFormation stacks, resources, and drift - [CloudTrail](https://agentserve.valnoraelric.com/docs/integrations/cloudtrail) Audit who did what in AWS with CloudTrail event history and Lake queries - [CloudWatch](https://agentserve.valnoraelric.com/docs/integrations/cloudwatch) Query and monitor AWS CloudWatch logs, metrics, and alarms - [Coda](https://agentserve.valnoraelric.com/docs/integrations/coda) Read and write Coda docs, pages, tables, and rows - [CodePipeline](https://agentserve.valnoraelric.com/docs/integrations/codepipeline) Run, monitor, and approve AWS CodePipeline pipelines - [Confluence](https://agentserve.valnoraelric.com/docs/integrations/confluence) Interact with Confluence - [Context.dev](https://agentserve.valnoraelric.com/docs/integrations/context_dev) Scrape, crawl, search, extract, and enrich web and brand data - [Convex](https://agentserve.valnoraelric.com/docs/integrations/convex) Use Convex database - [CrowdStrike](https://agentserve.valnoraelric.com/docs/integrations/crowdstrike) Investigate and respond to CrowdStrike Falcon alerts, hosts, IOCs, and vulnerabilities - [Crunchbase](https://agentserve.valnoraelric.com/docs/integrations/crunchbase) Search and look up companies, people, funding rounds, and acquisitions - [Cursor](https://agentserve.valnoraelric.com/docs/integrations/cursor) Launch and manage Cursor cloud agents to work on GitHub repositories - [Dagster](https://agentserve.valnoraelric.com/docs/integrations/dagster) Orchestrate data pipelines and manage job runs with Dagster - [Databricks](https://agentserve.valnoraelric.com/docs/integrations/databricks) Run SQL, manage jobs, and ask Genie agents on Databricks - [Datadog](https://agentserve.valnoraelric.com/docs/integrations/datadog) Monitor infrastructure, applications, and logs with Datadog - [Datagma](https://agentserve.valnoraelric.com/docs/integrations/datagma) Find verified B2B emails, mobile phones, and enrich person or company profiles - [Daytona](https://agentserve.valnoraelric.com/docs/integrations/daytona) Run code and commands in secure cloud sandboxes - [Deployments](https://agentserve.valnoraelric.com/docs/integrations/deployments) Manage workflow deployments - [Devin](https://agentserve.valnoraelric.com/docs/integrations/devin) Autonomous AI software engineer - [Dialpad](https://agentserve.valnoraelric.com/docs/integrations/dialpad) Place calls, send SMS, and manage contacts in Dialpad - [Discord](https://agentserve.valnoraelric.com/docs/integrations/discord) Interact with Discord - [DocuSign](https://agentserve.valnoraelric.com/docs/integrations/docusign) Send documents for e-signature via DocuSign - [Downdetector](https://agentserve.valnoraelric.com/docs/integrations/downdetector) Monitor outages and service status with Downdetector - [Dropbox](https://agentserve.valnoraelric.com/docs/integrations/dropbox) Upload, download, share, and manage files in Dropbox - [Dropcontact](https://agentserve.valnoraelric.com/docs/integrations/dropcontact) Enrich B2B contacts with verified email, phone, and company data - [DSPy](https://agentserve.valnoraelric.com/docs/integrations/dspy) Run predictions using self-hosted DSPy programs - [Dub](https://agentserve.valnoraelric.com/docs/integrations/dub) Link management with Dub - [DuckDuckGo](https://agentserve.valnoraelric.com/docs/integrations/duckduckgo) Search with DuckDuckGo - [Amazon DynamoDB](https://agentserve.valnoraelric.com/docs/integrations/dynamodb) Get, put, query, scan, update, and delete items in Amazon DynamoDB tables - [Dynatrace](https://agentserve.valnoraelric.com/docs/integrations/dynatrace) Manage Dynatrace problems, metrics, entities, logs, SLOs, settings, and security - [Elasticsearch](https://agentserve.valnoraelric.com/docs/integrations/elasticsearch) Search, index, and manage data in Elasticsearch - [ElevenLabs](https://agentserve.valnoraelric.com/docs/integrations/elevenlabs) Generate and transform audio with ElevenLabs - [Email Bison](https://agentserve.valnoraelric.com/docs/integrations/emailbison) Manage Email Bison leads, campaigns, replies, and tags - [Embeddings](https://agentserve.valnoraelric.com/docs/integrations/embeddings) Generate embeddings - [Enrich](https://agentserve.valnoraelric.com/docs/integrations/enrich) B2B data enrichment and LinkedIn intelligence with Enrich.so - [Data Enrichment](https://agentserve.valnoraelric.com/docs/integrations/enrichment) Enrich data with an Agent Serve enrichment - [Enrow](https://agentserve.valnoraelric.com/docs/integrations/enrow) Find and verify B2B emails with triple-verified accuracy - [Exa](https://agentserve.valnoraelric.com/docs/integrations/exa) Search with Exa AI - [Exotel](https://agentserve.valnoraelric.com/docs/integrations/exotel) Place and track business calls and SMS in India and Southeast Asia - [Extend](https://agentserve.valnoraelric.com/docs/integrations/extend) Parse and extract content from documents - [Fathom](https://agentserve.valnoraelric.com/docs/integrations/fathom) Access meeting recordings, transcripts, and summaries - [File](https://agentserve.valnoraelric.com/docs/integrations/file) Read, search, get content, fetch, write, append, compress, decompress, and manage sharing for files - [Findymail](https://agentserve.valnoraelric.com/docs/integrations/findymail) Find and verify B2B emails, phones, employees, and company data - [Firecrawl](https://agentserve.valnoraelric.com/docs/integrations/firecrawl) Scrape, search, crawl, map, and extract web data - [Fireflies](https://agentserve.valnoraelric.com/docs/integrations/fireflies) Interact with Fireflies.ai meeting transcripts and recordings - [Fish Audio](https://agentserve.valnoraelric.com/docs/integrations/fish_audio) Generate natural speech, clone voices, and transcribe audio with Fish Audio - [Fivetran](https://agentserve.valnoraelric.com/docs/integrations/fivetran) Manage Fivetran connections, syncs, and transformations - [Flint](https://agentserve.valnoraelric.com/docs/integrations/flint) Run background agent tasks on your Flint sites - [Freshdesk](https://agentserve.valnoraelric.com/docs/integrations/freshdesk) Manage Freshdesk tickets, replies, notes, contacts, and agents - [Freshsales](https://agentserve.valnoraelric.com/docs/integrations/freshsales) Manage Freshsales contacts, leads, deals, accounts, and sales activities - [Gamma](https://agentserve.valnoraelric.com/docs/integrations/gamma) Generate presentations, documents, and webpages with AI - [GitHub](https://agentserve.valnoraelric.com/docs/integrations/github) Interact with GitHub or trigger workflows from GitHub events - [GitLab](https://agentserve.valnoraelric.com/docs/integrations/gitlab) Interact with GitLab projects, issues, merge requests, and pipelines - [Gmail](https://agentserve.valnoraelric.com/docs/integrations/gmail) Send, read, search, and move Gmail messages or trigger workflows from Gmail events - [Gong](https://agentserve.valnoraelric.com/docs/integrations/gong) Revenue intelligence and conversation analytics - [Google Service Accounts](https://agentserve.valnoraelric.com/docs/integrations/google-service-account) Set up Google service accounts with domain-wide delegation for Gmail, Sheets, Drive, Calendar, and other Google services - [Google Ads](https://agentserve.valnoraelric.com/docs/integrations/google_ads) Query campaigns, capture lead form leads, and send offline conversions - [Google AppSheet](https://agentserve.valnoraelric.com/docs/integrations/google_appsheet) Read, add, edit, and delete rows in a Google AppSheet table - [Google BigQuery](https://agentserve.valnoraelric.com/docs/integrations/google_bigquery) Query, list, and insert data in Google BigQuery - [Google Books](https://agentserve.valnoraelric.com/docs/integrations/google_books) Search and retrieve book information - [Google Calendar](https://agentserve.valnoraelric.com/docs/integrations/google_calendar) Manage Google Calendar events - [Google Contacts](https://agentserve.valnoraelric.com/docs/integrations/google_contacts) Manage Google Contacts - [Google Docs](https://agentserve.valnoraelric.com/docs/integrations/google_docs) Read, write, create, and edit documents - [Google Drive](https://agentserve.valnoraelric.com/docs/integrations/google_drive) Manage files, folders, and permissions - [Google Forms](https://agentserve.valnoraelric.com/docs/integrations/google_forms) Manage Google Forms and responses - [Google Groups](https://agentserve.valnoraelric.com/docs/integrations/google_groups) Manage Google Workspace Groups and their members - [Google Maps](https://agentserve.valnoraelric.com/docs/integrations/google_maps) Geocoding, directions, places, and distance calculations - [Google Meet](https://agentserve.valnoraelric.com/docs/integrations/google_meet) Create and manage Google Meet meetings - [Google PageSpeed](https://agentserve.valnoraelric.com/docs/integrations/google_pagespeed) Analyze webpage performance with Google PageSpeed Insights - [Google Search](https://agentserve.valnoraelric.com/docs/integrations/google_search) Search the web - [Google Sheets](https://agentserve.valnoraelric.com/docs/integrations/google_sheets) Read, write, and update data with sheet selection - [Google Slides](https://agentserve.valnoraelric.com/docs/integrations/google_slides) Read, write, and create presentations - [Google Tasks](https://agentserve.valnoraelric.com/docs/integrations/google_tasks) Manage Google Tasks - [Google Translate](https://agentserve.valnoraelric.com/docs/integrations/google_translate) Translate text using Google Cloud Translation - [Google Vault](https://agentserve.valnoraelric.com/docs/integrations/google_vault) Search, export, and manage matters, holds, exports, and saved queries in Vault - [Grafana](https://agentserve.valnoraelric.com/docs/integrations/grafana) Interact with Grafana dashboards, alerts, and annotations - [Grain](https://agentserve.valnoraelric.com/docs/integrations/grain) Access meeting recordings, transcripts, and AI summaries - [Granola](https://agentserve.valnoraelric.com/docs/integrations/granola) Access meeting notes, transcripts, and audit events from Granola - [Greenhouse](https://agentserve.valnoraelric.com/docs/integrations/greenhouse) Manage recruiting with Greenhouse Harvest v3 - [Greptile](https://agentserve.valnoraelric.com/docs/integrations/greptile) AI-powered codebase search and Q&A - [Gupshup](https://agentserve.valnoraelric.com/docs/integrations/gupshup) Send and receive WhatsApp messages and templates through Gupshup - [Harmonic](https://agentserve.valnoraelric.com/docs/integrations/harmonic) Search and enrich private-market contacts - [Help Scout](https://agentserve.valnoraelric.com/docs/integrations/helpscout) Manage Help Scout conversations, replies, notes, and customers - [Hex](https://agentserve.valnoraelric.com/docs/integrations/hex) Run and manage Hex projects - [HubSpot Private App Tokens](https://agentserve.valnoraelric.com/docs/integrations/hubspot-service-account) Set up a HubSpot private app with a scoped access token to use HubSpot in Agent Serve workflows - [HubSpot setup guide](https://agentserve.valnoraelric.com/docs/integrations/hubspot-setup) Install, configure, use, and disconnect the Agent Serve HubSpot integration. - [HubSpot](https://agentserve.valnoraelric.com/docs/integrations/hubspot) Interact with HubSpot CRM, log calls, meetings, and tasks, or trigger workflows from HubSpot events - [Hugging Face](https://agentserve.valnoraelric.com/docs/integrations/huggingface) Use Hugging Face Inference API - [Hunter.io](https://agentserve.valnoraelric.com/docs/integrations/hunter) Find and verify professional email addresses - [AWS IAM](https://agentserve.valnoraelric.com/docs/integrations/iam) Manage AWS IAM users, roles, policies, and groups - [Icypeas](https://agentserve.valnoraelric.com/docs/integrations/icypeas) Find and verify professional email addresses - [AWS Identity Center](https://agentserve.valnoraelric.com/docs/integrations/identity_center) Manage temporary elevated access in AWS IAM Identity Center - [IMAP](https://agentserve.valnoraelric.com/docs/integrations/imap) IMAP triggers for automating workflows - [incident.io](https://agentserve.valnoraelric.com/docs/integrations/incidentio) Manage incidents with incident.io - [Integrations](https://agentserve.valnoraelric.com/docs/integrations) Connect third-party services and OAuth accounts for your workflows - [Infisical](https://agentserve.valnoraelric.com/docs/integrations/infisical) Manage secrets with Infisical - [Instagram](https://agentserve.valnoraelric.com/docs/integrations/instagram) Instagram triggers for automating workflows - [Instantly](https://agentserve.valnoraelric.com/docs/integrations/instantly) Manage Instantly leads, campaigns, emails, and lead lists - [Interakt](https://agentserve.valnoraelric.com/docs/integrations/interakt) Send WhatsApp templates and replies and sync contacts with Interakt - [Intercom](https://agentserve.valnoraelric.com/docs/integrations/intercom) Manage contacts, companies, conversations, tickets, and messages in Intercom - [Microsoft Intune](https://agentserve.valnoraelric.com/docs/integrations/intune) Manage devices, application inventory, and compliance with Microsoft Intune - [Jina](https://agentserve.valnoraelric.com/docs/integrations/jina) Search the web or extract content from URLs - [Jira](https://agentserve.valnoraelric.com/docs/integrations/jira) Interact with Jira - [Jira Service Management](https://agentserve.valnoraelric.com/docs/integrations/jira_service_management) Interact with Jira Service Management - [Jotform](https://agentserve.valnoraelric.com/docs/integrations/jotform) Read submissions, manage forms, and wire up webhooks in Jotform - [Jupyter](https://agentserve.valnoraelric.com/docs/integrations/jupyter) Manage files, notebooks, kernels, and sessions on a Jupyter server - [JustCall](https://agentserve.valnoraelric.com/docs/integrations/justcall) Log calls, send SMS, and manage contacts in the JustCall cloud phone system - [Kalshi](https://agentserve.valnoraelric.com/docs/integrations/kalshi) Access prediction markets and trade on Kalshi - [Ketch](https://agentserve.valnoraelric.com/docs/integrations/ketch) Manage privacy consent, subscriptions, and data subject rights - [Knowledge](https://agentserve.valnoraelric.com/docs/integrations/knowledge) Use vector search - [Lambda](https://agentserve.valnoraelric.com/docs/integrations/lambda) Invoke, deploy, and manage AWS Lambda functions - [LangSmith](https://agentserve.valnoraelric.com/docs/integrations/langsmith) Forward workflow runs to LangSmith for observability - [LaTeX](https://agentserve.valnoraelric.com/docs/integrations/latex) Compile LaTeX documents into PDFs - [LaunchDarkly](https://agentserve.valnoraelric.com/docs/integrations/launchdarkly) Manage feature flags with LaunchDarkly. - [LeadMagic](https://agentserve.valnoraelric.com/docs/integrations/leadmagic) Find and enrich B2B contacts, emails, mobile numbers, and company data - [LeadSquared](https://agentserve.valnoraelric.com/docs/integrations/leadsquared) Manage LeadSquared leads, activities, tasks, notes, and opportunities - [Lemlist](https://agentserve.valnoraelric.com/docs/integrations/lemlist) Manage outreach activities, leads, and send emails via Lemlist - [Linear API Keys](https://agentserve.valnoraelric.com/docs/integrations/linear-service-account) Connect Linear to Agent Serve with a personal API key — ideally created from a dedicated service user for production workflows - [Linear](https://agentserve.valnoraelric.com/docs/integrations/linear) Interact with Linear issues, projects, and more - [LinkedIn](https://agentserve.valnoraelric.com/docs/integrations/linkedin) Share posts and manage your LinkedIn presence - [LinkedIn Pages](https://agentserve.valnoraelric.com/docs/integrations/linkedin_pages) Post to, read, and measure LinkedIn Company Pages - [Linkup](https://agentserve.valnoraelric.com/docs/integrations/linkup) Search the web with Linkup - [Linq](https://agentserve.valnoraelric.com/docs/integrations/linq) Send iMessage, SMS, and RCS messages and manage conversations with Linq - [Logfire](https://agentserve.valnoraelric.com/docs/integrations/logfire) Query traces, logs, and metrics in Pydantic Logfire - [LogRocket](https://agentserve.valnoraelric.com/docs/integrations/logrocket) Summarize sessions, manage users, and tag releases in LogRocket - [Logs](https://agentserve.valnoraelric.com/docs/integrations/logs) Query workflow runs and fetch run details - [Loops](https://agentserve.valnoraelric.com/docs/integrations/loops) Manage contacts and send emails with Loops - [Luma](https://agentserve.valnoraelric.com/docs/integrations/luma) Manage events and guests on Luma - [Mailchimp](https://agentserve.valnoraelric.com/docs/integrations/mailchimp) Manage audiences, campaigns, and marketing automation in Mailchimp - [Mailgun](https://agentserve.valnoraelric.com/docs/integrations/mailgun) Send emails and manage mailing lists with Mailgun - [Claude Managed Agents](https://agentserve.valnoraelric.com/docs/integrations/managed_agent) Run a Claude Platform Managed Agent - [ManageEngine ServiceDesk Plus](https://agentserve.valnoraelric.com/docs/integrations/manageengine_sdp) Manage ServiceDesk Plus Cloud requests, problems, changes, assets, and knowledge base solutions - [Mem0](https://agentserve.valnoraelric.com/docs/integrations/mem0) Agent memory management - [Memory](https://agentserve.valnoraelric.com/docs/integrations/memory) Add memory store - [Facebook Messenger](https://agentserve.valnoraelric.com/docs/integrations/messenger) Reply to people who message your Facebook Page on Messenger - [Meta Lead Ads](https://agentserve.valnoraelric.com/docs/integrations/meta_lead_ads) Capture Facebook and Instagram lead form submissions the moment they arrive - [Azure AD](https://agentserve.valnoraelric.com/docs/integrations/microsoft_ad) Manage identities, licenses, roles, and access in Azure AD (Microsoft Entra ID) - [Microsoft Dataverse](https://agentserve.valnoraelric.com/docs/integrations/microsoft_dataverse) Manage records in Microsoft Dataverse tables - [Microsoft Dynamics 365 CRM](https://agentserve.valnoraelric.com/docs/integrations/microsoft_dynamics_365) Manage customers, sales pipelines, and support cases in Dynamics 365 CRM - [Microsoft Excel](https://agentserve.valnoraelric.com/docs/integrations/microsoft_excel) Manage worksheets, tables, rows, and workbook sessions - [Microsoft Planner](https://agentserve.valnoraelric.com/docs/integrations/microsoft_planner) Manage tasks, plans, and buckets in Microsoft Planner - [Microsoft Teams](https://agentserve.valnoraelric.com/docs/integrations/microsoft_teams) Manage messages, reactions, and members in Teams - [Microsoft Word](https://agentserve.valnoraelric.com/docs/integrations/microsoft_word) Create, fill, read, edit, and export Word documents - [MillionVerifier](https://agentserve.valnoraelric.com/docs/integrations/millionverifier) Verify email deliverability and check account credits - [Mintlify](https://agentserve.valnoraelric.com/docs/integrations/mintlify) Deploy, edit, search, and measure Mintlify documentation - [Mistral Parser](https://agentserve.valnoraelric.com/docs/integrations/mistral_parse) Extract text from PDF documents - [Modal](https://agentserve.valnoraelric.com/docs/integrations/modal) Call deployed Modal functions and endpoints - [monday.com API Tokens](https://agentserve.valnoraelric.com/docs/integrations/monday-service-account) Set up a monday.com personal API token on a dedicated integration user to use monday.com in Agent Serve workflows - [Monday](https://agentserve.valnoraelric.com/docs/integrations/monday) Manage Monday.com boards, items, and groups - [MongoDB](https://agentserve.valnoraelric.com/docs/integrations/mongodb) Connect to MongoDB database - [MSG91](https://agentserve.valnoraelric.com/docs/integrations/msg91) Send DLT-compliant SMS, OTPs, and WhatsApp messages in India - [Microsoft SQL Server](https://agentserve.valnoraelric.com/docs/integrations/mssql) Connect to Microsoft SQL Server database - [MySQL](https://agentserve.valnoraelric.com/docs/integrations/mysql) Connect to MySQL database - [Neo4j](https://agentserve.valnoraelric.com/docs/integrations/neo4j) Connect to Neo4j graph database - [Oracle NetSuite Service Account](https://agentserve.valnoraelric.com/docs/integrations/netsuite-service-account) Configure certificate-based OAuth 2.0 client credentials once and reuse them across NetSuite blocks - [Oracle NetSuite](https://agentserve.valnoraelric.com/docs/integrations/netsuite) Manage NetSuite records, queries, datasets, batches, and async jobs - [NeverBounce](https://agentserve.valnoraelric.com/docs/integrations/neverbounce) Verify email deliverability and check account credits - [New Relic](https://agentserve.valnoraelric.com/docs/integrations/new_relic) Query observability data and record deployments in New Relic - [Notion Internal Integrations](https://agentserve.valnoraelric.com/docs/integrations/notion-service-account) Set up a Notion internal integration with an integration secret to use Notion in Agent Serve workflows - [Notion](https://agentserve.valnoraelric.com/docs/integrations/notion) Manage Notion pages - [Obsidian](https://agentserve.valnoraelric.com/docs/integrations/obsidian) Interact with your Obsidian vault via the Local REST API - [Okta](https://agentserve.valnoraelric.com/docs/integrations/okta) Manage users, groups, apps, and MFA in Okta - [OneDrive](https://agentserve.valnoraelric.com/docs/integrations/onedrive) Create, upload, download, search, move, copy, share, and delete files - [1Password](https://agentserve.valnoraelric.com/docs/integrations/onepassword) Manage secrets and items in 1Password vaults - [Oracle Fusion Financials](https://agentserve.valnoraelric.com/docs/integrations/oracle_fusion_financials) Manage receivables and expenses, and report on payables and ledgers - [Oracle Database](https://agentserve.valnoraelric.com/docs/integrations/oracledb) Connect directly to an Oracle Database - [Otter.ai](https://agentserve.valnoraelric.com/docs/integrations/otter) Read Otter.ai meeting conversations, transcripts, and summaries - [Outlook](https://agentserve.valnoraelric.com/docs/integrations/outlook) Send, read, search, reply, organize, and manage Outlook email and calendar - [PagerDuty](https://agentserve.valnoraelric.com/docs/integrations/pagerduty) Manage incidents and on-call schedules with PagerDuty - [Parallel AI](https://agentserve.valnoraelric.com/docs/integrations/parallel_ai) Web research with Parallel AI - [People Data Labs](https://agentserve.valnoraelric.com/docs/integrations/peopledatalabs) Enrich and search people and companies - [Perplexity](https://agentserve.valnoraelric.com/docs/integrations/perplexity) Use Perplexity AI for chat and search - [Persona](https://agentserve.valnoraelric.com/docs/integrations/persona) Verify identities with Persona - [Pinecone](https://agentserve.valnoraelric.com/docs/integrations/pinecone) Use Pinecone vector database - [Pipedrive API Tokens](https://agentserve.valnoraelric.com/docs/integrations/pipedrive-service-account) Connect Pipedrive to Agent Serve with a personal API token instead of an OAuth login - [Pipedrive](https://agentserve.valnoraelric.com/docs/integrations/pipedrive) Interact with Pipedrive CRM - [PitchBook](https://agentserve.valnoraelric.com/docs/integrations/pitchbook) Look up private market data on companies, deals, investors, funds, and people - [Plane](https://agentserve.valnoraelric.com/docs/integrations/plane) Manage projects and work items in Plane - [PlanetScale](https://agentserve.valnoraelric.com/docs/integrations/planetscale) Manage PlanetScale databases, branches, backups, and deploy requests - [Plivo](https://agentserve.valnoraelric.com/docs/integrations/plivo) Place calls and send SMS, MMS, and WhatsApp messages with Plivo - [Polymarket](https://agentserve.valnoraelric.com/docs/integrations/polymarket) Access prediction markets data from Polymarket - [PostgreSQL](https://agentserve.valnoraelric.com/docs/integrations/postgresql) Connect to PostgreSQL database - [PostHog](https://agentserve.valnoraelric.com/docs/integrations/posthog) Product analytics and feature management - [Power BI](https://agentserve.valnoraelric.com/docs/integrations/powerbi) Query semantic models and manage reports and refreshes - [Profound](https://agentserve.valnoraelric.com/docs/integrations/profound) AI visibility and analytics with Profound - [Prospeo](https://agentserve.valnoraelric.com/docs/integrations/prospeo) Enrich and search B2B contacts and companies - [Pulse](https://agentserve.valnoraelric.com/docs/integrations/pulse) Extract text from documents using Pulse OCR - [Qdrant](https://agentserve.valnoraelric.com/docs/integrations/qdrant) Use Qdrant vector database - [Quartr](https://agentserve.valnoraelric.com/docs/integrations/quartr) Access earnings calls, transcripts, filings, and slides - [QuickBooks](https://agentserve.valnoraelric.com/docs/integrations/quickbooks) Manage QuickBooks Online company, transactions, reports, emails, PDFs, and attachments - [Quiver](https://agentserve.valnoraelric.com/docs/integrations/quiver) Generate and vectorize SVGs - [RabbitMQ](https://agentserve.valnoraelric.com/docs/integrations/rabbitmq) Publish and read messages and manage queues in RabbitMQ - [Railway](https://agentserve.valnoraelric.com/docs/integrations/railway) Manage Railway projects, services, deployments, and variables - [Ramp](https://agentserve.valnoraelric.com/docs/integrations/ramp) Read spend, bills, cards, and reimbursements, and add transaction memos in Ramp - [Razorpay](https://agentserve.valnoraelric.com/docs/integrations/razorpay) Collect payments in India with Razorpay Payment Links, orders, refunds, and UPI QR - [RB2B](https://agentserve.valnoraelric.com/docs/integrations/rb2b) Identify and enrich website visitors - [Amazon RDS](https://agentserve.valnoraelric.com/docs/integrations/rds) Connect to Amazon RDS via Data API - [Reddit](https://agentserve.valnoraelric.com/docs/integrations/reddit) Access Reddit data and content - [Redis](https://agentserve.valnoraelric.com/docs/integrations/redis) Key-value operations with Redis - [Reducto](https://agentserve.valnoraelric.com/docs/integrations/reducto) Extract text from PDF documents - [Resend](https://agentserve.valnoraelric.com/docs/integrations/resend) Send emails and manage contacts with Resend. - [Retell AI](https://agentserve.valnoraelric.com/docs/integrations/retell) Place voice AI phone calls and read transcripts and call analysis with Retell AI - [RevenueCat](https://agentserve.valnoraelric.com/docs/integrations/revenuecat) Manage in-app subscriptions and entitlements - [Rippling](https://agentserve.valnoraelric.com/docs/integrations/rippling) Manage workers, departments, custom objects, and company data in Rippling - [Rocketlane](https://agentserve.valnoraelric.com/docs/integrations/rocketlane) Manage client onboarding projects, tasks, time tracking, and invoices - [Rootly](https://agentserve.valnoraelric.com/docs/integrations/rootly) Manage incidents, alerts, and on-call with Rootly - [S3](https://agentserve.valnoraelric.com/docs/integrations/s3) Upload, download, list, and manage S3 files and buckets - [SailPoint](https://agentserve.valnoraelric.com/docs/integrations/sailpoint) Govern identities and access in SailPoint Identity Security Cloud - [Salesforce Integration Users](https://agentserve.valnoraelric.com/docs/integrations/salesforce-service-account) Set up a Salesforce External Client App with the Client Credentials Flow or the JWT Bearer Flow and a dedicated integration user to use Salesforce in Agent Serve workflows - [Salesforce](https://agentserve.valnoraelric.com/docs/integrations/salesforce) Interact with Salesforce CRM - [SAP Concur](https://agentserve.valnoraelric.com/docs/integrations/sap_concur) Manage expense reports, travel requests, cash advances, and more in SAP Concur - [SAP S4HANA](https://agentserve.valnoraelric.com/docs/integrations/sap_s4hana) Read and write SAP S4HANA Cloud business data via OData - [Sarvam AI](https://agentserve.valnoraelric.com/docs/integrations/sarvam) Speak, transcribe, and translate Indian languages and Hinglish - [AWS Secrets Manager](https://agentserve.valnoraelric.com/docs/integrations/secrets_manager) Connect to AWS Secrets Manager - [Semrush](https://agentserve.valnoraelric.com/docs/integrations/semrush) Research SEO and paid search data with Semrush - [Sendblue](https://agentserve.valnoraelric.com/docs/integrations/sendblue) Send and receive iMessage and SMS - [SendGrid](https://agentserve.valnoraelric.com/docs/integrations/sendgrid) Send emails and manage contacts, lists, and templates with SendGrid - [Sentry](https://agentserve.valnoraelric.com/docs/integrations/sentry) Manage Sentry issues, projects, events, and releases - [Serper](https://agentserve.valnoraelric.com/docs/integrations/serper) Search the web using Serper - [ServiceNow](https://agentserve.valnoraelric.com/docs/integrations/servicenow) Create, read, update, and delete ServiceNow records - [AWS SES](https://agentserve.valnoraelric.com/docs/integrations/ses) Send emails and manage templates with AWS Simple Email Service - [SFTP](https://agentserve.valnoraelric.com/docs/integrations/sftp) Transfer files via SFTP (SSH File Transfer Protocol) - [SharePoint](https://agentserve.valnoraelric.com/docs/integrations/sharepoint) Work with pages and lists - [Shopify Admin API Tokens](https://agentserve.valnoraelric.com/docs/integrations/shopify-service-account) Set up a Shopify custom app with an Admin API access token to use Shopify in Agent Serve workflows - [Shopify](https://agentserve.valnoraelric.com/docs/integrations/shopify) Manage products, orders, customers, and inventory in your Shopify store - [Similarweb](https://agentserve.valnoraelric.com/docs/integrations/similarweb) Website traffic and analytics data - [Sixtyfour AI](https://agentserve.valnoraelric.com/docs/integrations/sixtyfour) Enrich leads and companies with AI-powered research - [Slack](https://agentserve.valnoraelric.com/docs/integrations/slack) Manage Slack messages, channels, users, files, Lists, canvases, and Agent Sessions - [Smartlead](https://agentserve.valnoraelric.com/docs/integrations/smartlead) Manage Smartlead cold email campaigns, sequences, and leads - [SMTP](https://agentserve.valnoraelric.com/docs/integrations/smtp) Send emails via any SMTP mail server - [Snowflake Programmatic Access Tokens](https://agentserve.valnoraelric.com/docs/integrations/snowflake-service-account) Create a Snowflake programmatic access token and connect it to Agent Serve so workflows can query your account - [Snowflake](https://agentserve.valnoraelric.com/docs/integrations/snowflake) Query data, ask Cortex Analyst, and manage warehouses and tasks in Snowflake - [Splunk](https://agentserve.valnoraelric.com/docs/integrations/splunk) Run SPL searches and manage saved searches and alerts in Splunk - [Sportmonks](https://agentserve.valnoraelric.com/docs/integrations/sportmonks) Access Sportmonks football, motorsport, odds, and reference data - [Amazon SQS](https://agentserve.valnoraelric.com/docs/integrations/sqs) Connect to Amazon SQS - [Square](https://agentserve.valnoraelric.com/docs/integrations/square) Process payments and manage Square commerce data - [SSH](https://agentserve.valnoraelric.com/docs/integrations/ssh) Connect to remote servers via SSH - [AWS Systems Manager](https://agentserve.valnoraelric.com/docs/integrations/ssm) Run commands, manage parameters, and audit managed nodes - [Stagehand](https://agentserve.valnoraelric.com/docs/integrations/stagehand) Web automation and data extraction - [Stripe](https://agentserve.valnoraelric.com/docs/integrations/stripe) Process payments and manage Stripe data - [AWS STS](https://agentserve.valnoraelric.com/docs/integrations/sts) Connect to AWS Security Token Service - [Supabase](https://agentserve.valnoraelric.com/docs/integrations/supabase) Use Supabase database - [Table](https://agentserve.valnoraelric.com/docs/integrations/table) User-defined data tables - [Tailscale](https://agentserve.valnoraelric.com/docs/integrations/tailscale) Manage devices and network settings in your Tailscale tailnet - [Tavily](https://agentserve.valnoraelric.com/docs/integrations/tavily) Search and extract information - [Telegram](https://agentserve.valnoraelric.com/docs/integrations/telegram) Interact with Telegram - [Temporal](https://agentserve.valnoraelric.com/docs/integrations/temporal) Start, signal, query, and manage Temporal workflow executions - [AWS Textract](https://agentserve.valnoraelric.com/docs/integrations/textract) Extract text, tables, and forms from documents - [Thrive](https://agentserve.valnoraelric.com/docs/integrations/thrive) Manage users, audiences, learning and CPD on Thrive - [TikTok](https://agentserve.valnoraelric.com/docs/integrations/tiktok) Access TikTok profiles and videos, and upload inbox drafts - [Tinybird](https://agentserve.valnoraelric.com/docs/integrations/tinybird) Send events, query data, and manage Data Sources with Tinybird - [TinyFish](https://agentserve.valnoraelric.com/docs/integrations/tinyfish) Automate and read the live web - [Trello API Tokens](https://agentserve.valnoraelric.com/docs/integrations/trello-service-account) Mint a Trello API token bound to Agent Serve's API key to use Trello in Agent Serve workflows without OAuth - [Trello](https://agentserve.valnoraelric.com/docs/integrations/trello) Manage Trello lists, cards, checklists, and activity - [Trigger.dev](https://agentserve.valnoraelric.com/docs/integrations/trigger_dev) Trigger tasks and manage runs and schedules - [Twilio](https://agentserve.valnoraelric.com/docs/integrations/twilio) Twilio triggers for automating workflows - [Twilio SMS](https://agentserve.valnoraelric.com/docs/integrations/twilio_sms) Send SMS and WhatsApp, look up numbers, and verify users - [Twilio Voice](https://agentserve.valnoraelric.com/docs/integrations/twilio_voice) Make, control, and review phone calls - [Typeform](https://agentserve.valnoraelric.com/docs/integrations/typeform) Interact with Typeform - [Upstash](https://agentserve.valnoraelric.com/docs/integrations/upstash) Serverless Redis with Upstash - [UptimeRobot](https://agentserve.valnoraelric.com/docs/integrations/uptimerobot) Monitor uptime, manage incidents, maintenance windows, and status pages - [Vanta](https://agentserve.valnoraelric.com/docs/integrations/vanta) Query compliance status and manage evidence in Vanta - [Vapi](https://agentserve.valnoraelric.com/docs/integrations/vapi) Place voice AI phone calls and read their transcripts and analysis with Vapi - [Vercel](https://agentserve.valnoraelric.com/docs/integrations/vercel) Manage Vercel deployments, projects, and infrastructure - [Wati](https://agentserve.valnoraelric.com/docs/integrations/wati) Send and track WhatsApp messages, templates, and contacts through Wati - [Wealthbox API Access Tokens](https://agentserve.valnoraelric.com/docs/integrations/wealthbox-service-account) Set up a Wealthbox API access token to use Wealthbox in Agent Serve workflows without OAuth - [Wealthbox](https://agentserve.valnoraelric.com/docs/integrations/wealthbox) Interact with Wealthbox - [Webflow Site Tokens](https://agentserve.valnoraelric.com/docs/integrations/webflow-service-account) Set up a Webflow site API token with the right scopes to use Webflow CMS in Agent Serve workflows - [Webflow](https://agentserve.valnoraelric.com/docs/integrations/webflow) Manage Webflow CMS collections - [WhatsApp](https://agentserve.valnoraelric.com/docs/integrations/whatsapp) Send WhatsApp messages and Flows, and manage templates and business profiles - [Wikipedia](https://agentserve.valnoraelric.com/docs/integrations/wikipedia) Search and retrieve content from Wikipedia - [Windchill](https://agentserve.valnoraelric.com/docs/integrations/windchill) Manage documents, revisions, and content in PTC Windchill - [Wiza](https://agentserve.valnoraelric.com/docs/integrations/wiza) Find, enrich, and verify B2B contact data with Wiza - [WordPress](https://agentserve.valnoraelric.com/docs/integrations/wordpress) Manage WordPress content - [Workday](https://agentserve.valnoraelric.com/docs/integrations/workday) Manage workers, hiring, onboarding, and HR operations in Workday - [X](https://agentserve.valnoraelric.com/docs/integrations/x) Interact with X - [You.com](https://agentserve.valnoraelric.com/docs/integrations/youcom) Search, read, and research the web with You.com - [YouTube](https://agentserve.valnoraelric.com/docs/integrations/youtube) Interact with YouTube videos, channels, and playlists - [Zendesk](https://agentserve.valnoraelric.com/docs/integrations/zendesk) Manage support tickets, users, and organizations in Zendesk - [Zep](https://agentserve.valnoraelric.com/docs/integrations/zep) Long-term memory for AI agents - [ZeroBounce](https://agentserve.valnoraelric.com/docs/integrations/zerobounce) Validate email deliverability and check account credits - [Zoho Desk Self Clients](https://agentserve.valnoraelric.com/docs/integrations/zoho-desk-service-account) Set up a Zoho Self Client so your workflows can call Zoho Desk without a personal OAuth login - [Zoho CRM](https://agentserve.valnoraelric.com/docs/integrations/zoho_crm) Manage Zoho CRM leads, contacts, deals, calls, tasks, and notes - [Zoho Desk](https://agentserve.valnoraelric.com/docs/integrations/zoho_desk) Manage Zoho Desk tickets, replies, contacts, and accounts - [Zoom Server-to-Server OAuth Apps](https://agentserve.valnoraelric.com/docs/integrations/zoom-service-account) Set up a Zoom Server-to-Server OAuth app so your workflows can call Zoom without a personal OAuth login - [Zoom](https://agentserve.valnoraelric.com/docs/integrations/zoom) Create and manage Zoom meetings and recordings - [ZoomInfo](https://agentserve.valnoraelric.com/docs/integrations/zoominfo) Search and enrich B2B company and contact data with ZoomInfo. ### Search - [Confluence](https://agentserve.valnoraelric.com/docs/search/confluence) Connect Confluence Cloud spaces and set up each teammate's search access - [Connect your account](https://agentserve.valnoraelric.com/docs/search/connect-your-account) Join your team's Search sources and finish connecting your own accounts - [GitHub](https://agentserve.valnoraelric.com/docs/search/github) Index repository files with a GitHub App while preserving each person's access - [GitLab](https://agentserve.valnoraelric.com/docs/search/gitlab) Connect a self-managed GitLab project with an administrator token or a non-admin token and CSV permissions - [Gmail](https://agentserve.valnoraelric.com/docs/search/gmail) Connect personal Gmail accounts or index Workspace mailboxes with a delegated service account - [Google Calendar](https://agentserve.valnoraelric.com/docs/search/google-calendar) Connect personal Calendar accounts or index your company with a delegated service account - [Google Drive](https://agentserve.valnoraelric.com/docs/search/google-drive) Connect personal Drive accounts or index your company with a delegated service account - [Search](https://agentserve.valnoraelric.com/docs/search) Connect your team's sources and search the documents each person can access - [Jira](https://agentserve.valnoraelric.com/docs/search/jira) Connect Jira Cloud projects to Search using each teammate's account - [Search MCP](https://agentserve.valnoraelric.com/docs/search/mcp) Search your organization's sources from Claude, Codex, Cursor, and other MCP apps - [Slack](https://agentserve.valnoraelric.com/docs/search/slack) Install the Slack app and connect members to search channels and messages ### Spaces - [Spaces and Chat](https://agentserve.valnoraelric.com/docs/spaces/chat) Ask Chat about a doc, have it draft new docs, and review the edits it suggests before they land. - [Collaboration](https://agentserve.valnoraelric.com/docs/spaces/collaboration) Edit docs together in real time, comment and @mention teammates, and restore earlier versions. - [Databases](https://agentserve.valnoraelric.com/docs/spaces/databases) Track work in a table or board inside a doc, then turn it into an Agent Serve table your agents can use. - [Spaces](https://agentserve.valnoraelric.com/docs/spaces) Write docs and draw on whiteboards with your team, right next to your agents, tables, and Chat. - [Organizing](https://agentserve.valnoraelric.com/docs/spaces/organizing) Personal and shared spaces, folders, tags, collections, favorites, journals, search, and trash. - [Pages and whiteboards](https://agentserve.valnoraelric.com/docs/spaces/pages-and-whiteboards) Write docs with blocks, draw on an open canvas, and switch any doc between the two. - [Sharing and permissions](https://agentserve.valnoraelric.com/docs/spaces/sharing) Doc roles, sharing with people, links for your workspace, public pages, and the controls admins have. - [Templates, import, and export](https://agentserve.valnoraelric.com/docs/spaces/templates-import-export) Start new docs from templates, bring in Markdown and HTML, and export to Markdown, HTML, PNG, or PDF. ### Tables - [Enrichments](https://agentserve.valnoraelric.com/docs/tables/enrichments) Fill table columns with looked-up data — work emails, phone numbers, LinkedIn profiles, and company details. - [Tables](https://agentserve.valnoraelric.com/docs/tables) A grid of typed columns and rows in your workspace, for data your workflows read and write. - [Using tables in workflows](https://agentserve.valnoraelric.com/docs/tables/using-in-workflows) How a workflow reads, writes, and updates table rows with the Table block. - [Workflow columns](https://agentserve.valnoraelric.com/docs/tables/workflow-columns) A column backed by a workflow that runs once per row, reading chosen columns as inputs and writing its results back into result columns. ### Workflows - [Connections](https://agentserve.valnoraelric.com/docs/workflows/connections) The syntax for referencing an earlier block's output and the shape of common block outputs. - [How blocks pass data](https://agentserve.valnoraelric.com/docs/workflows/data-flow) What a block's output is, how blocks reference earlier outputs, and the data types you'll work with. - [How workflows run](https://agentserve.valnoraelric.com/docs/workflows/how-it-runs) How Agent Serve orders the blocks, runs independent ones in parallel, and follows branches. - [Workflows](https://agentserve.valnoraelric.com/docs/workflows) A workflow is a visual program made of blocks, a saved procedure your AI systems run. - [Variables](https://agentserve.valnoraelric.com/docs/workflows/variables) Define reusable workflow variables referenced with angle brackets and environment variables referenced with double curly braces. - [Agent](https://agentserve.valnoraelric.com/docs/workflows/blocks/agent) The Agent block runs a model over your inputs to reason, call tools, and return text or structured output. - [API](https://agentserve.valnoraelric.com/docs/workflows/blocks/api) The API block makes an HTTP request to an external service and returns the response. - [Condition](https://agentserve.valnoraelric.com/docs/workflows/blocks/condition) The Condition block branches a workflow on boolean expressions, with no model call. - [Credential](https://agentserve.valnoraelric.com/docs/workflows/blocks/credential) Select workspace OAuth credentials or find organization OAuth and MCP account references for downstream blocks. - [Evaluator](https://agentserve.valnoraelric.com/docs/workflows/blocks/evaluator) The Evaluator block uses a model to score content against metrics you define. - [Function](https://agentserve.valnoraelric.com/docs/workflows/blocks/function) The Function block runs your JavaScript, Python, or Shell code as a step and returns what it produces. - [Guardrails](https://agentserve.valnoraelric.com/docs/workflows/blocks/guardrails) The Guardrails block checks content against a validation type before it moves through the workflow. - [Human in the Loop](https://agentserve.valnoraelric.com/docs/workflows/blocks/human-in-the-loop) The Human in the Loop block pauses a run for human approval, then resumes with their input. - [Logs](https://agentserve.valnoraelric.com/docs/workflows/blocks/logs) - [Loop](https://agentserve.valnoraelric.com/docs/workflows/blocks/loop) The Loop block is a container that runs the blocks inside it repeatedly — over a collection, a count, or while a condition holds. - [Parallel](https://agentserve.valnoraelric.com/docs/workflows/blocks/parallel) The Parallel block is a container that runs the block inside it concurrently — once per item or a fixed number of times. - [Pi Coding Agent](https://agentserve.valnoraelric.com/docs/workflows/blocks/pi) The Pi Coding Agent block runs an autonomous coding agent on a real repository — creating or updating a pull request, reviewing a PR, or editing files over SSH. - [Response](https://agentserve.valnoraelric.com/docs/workflows/blocks/response) The Response block ends an API-triggered workflow and returns a structured HTTP response. - [Router](https://agentserve.valnoraelric.com/docs/workflows/blocks/router) The Router block uses a model to pick one of several paths based on the content it reads. - [Variables](https://agentserve.valnoraelric.com/docs/workflows/blocks/variables) The Variables block updates workflow variables during a run, read from any block by name. - [Wait](https://agentserve.valnoraelric.com/docs/workflows/blocks/wait) The Wait block pauses a workflow for a set time before continuing. - [Webhook](https://agentserve.valnoraelric.com/docs/workflows/blocks/webhook) The Webhook block sends an HTTP POST to an external endpoint, with automatic headers and optional signing. - [Workflow Block](https://agentserve.valnoraelric.com/docs/workflows/blocks/workflow) Run another workflow inside the current flow - [Agent stream events](https://agentserve.valnoraelric.com/docs/workflows/deployment/agent-events) Protocol for streaming thinking and tool lifecycle from Agent blocks - [API deployment](https://agentserve.valnoraelric.com/docs/workflows/deployment/api) - [Chat deployment](https://agentserve.valnoraelric.com/docs/workflows/deployment/chat) - [Deploy Workflows](https://agentserve.valnoraelric.com/docs/workflows/deployment) How a workflow becomes an operational system that outside callers can run, with versioned snapshots and rollback. - [MCP deployment](https://agentserve.valnoraelric.com/docs/workflows/deployment/mcp) Expose your workflows as MCP tools for external AI assistants and applications - [Agent Serve Workspace Events](https://agentserve.valnoraelric.com/docs/workflows/triggers/agentserve) - [RSS Feed](https://agentserve.valnoraelric.com/docs/workflows/triggers/rss) The RSS trigger runs a workflow when a new item is published to an RSS or Atom feed. - [Schedule](https://agentserve.valnoraelric.com/docs/workflows/triggers/schedule) The Schedule trigger runs a workflow on a timer — a simple interval or a cron expression. - [Start Trigger](https://agentserve.valnoraelric.com/docs/workflows/triggers/start) The Start block is the default trigger — it collects typed inputs and runs the workflow from the editor, an API call, or chat. - [Table](https://agentserve.valnoraelric.com/docs/workflows/triggers/table) The Table trigger runs a workflow when a row is inserted or updated in an Agent Serve table. - [Webhook](https://agentserve.valnoraelric.com/docs/workflows/triggers/webhook) The Webhook trigger runs a workflow on any inbound HTTP request to a URL Agent Serve generates. ### Workspace - [Command palette](https://agentserve.valnoraelric.com/docs/workspace/command-palette) Search the whole workspace and run actions from the keyboard with ⌘K. - [The workspace](https://agentserve.valnoraelric.com/docs/workspace) A tour of the Agent Serve app — the left rail, the Team spaces tabs, the getting started checklist, and notifications. ## Additional Resources - [Full documentation content](https://agentserve.valnoraelric.com/docs/llms-full.txt) - Individual page content: https://agentserve.valnoraelric.com/docs/llms.mdx/[page-path] - [API documentation](https://agentserve.valnoraelric.com/docs/api-reference/) - [Tool integrations](https://agentserve.valnoraelric.com/docs/tools/) ## Statistics - Total pages: 907 --- Generated: 2026-11-10T14:36:13.667Z Format: llms.txt v0.1.0 See: https://llmstxt.org for specification