# Orchestrivo - [Welcome to Orchestrivo](https://docs.orchestrivo.com/index.md): Orchestrivo is an AI agent platform. Build AI agents that use your tools and data to do real work, then automate them with triggers, schedules, and the API. - [OrchestrivoAssistant](https://docs.orchestrivo.com/core-concepts/orchestrivoassistant.md): Your personal Orchestrivo agent: chat, a labeled inbox, a morning report, and a brief before every meeting. - [Text OrchestrivoAssistant](https://docs.orchestrivo.com/core-concepts/text_orchestrivoassistant.md) - [Agents](https://docs.orchestrivo.com/core-concepts/agents.md) - [Agent access](https://docs.orchestrivo.com/core-concepts/agent_access.md) - [Agent performance](https://docs.orchestrivo.com/core-concepts/agent_performance.md): Insights, Evaluations, and Tasks for a single agent - [Evaluations](https://docs.orchestrivo.com/core-concepts/evaluations.md): Automatically grade every agent interaction against your criteria, collect structured data, and tag conversations for reporting. - [Reflections](https://docs.orchestrivo.com/core-concepts/reflections.md) - [Talk mode](https://docs.orchestrivo.com/core-concepts/talk_mode.md) - [Human in the loop](https://docs.orchestrivo.com/core-concepts/human_in_the_loop.md): Keep humans in control of your AI agents with tool approval settings, app rules, and the Ask Question ability. - [Code sandbox & secrets](https://docs.orchestrivo.com/core-concepts/agent_sandbox_and_secrets.md): Secure code execution and credential management for your AI agents. - [Agent skills](https://docs.orchestrivo.com/core-concepts/skills.md): Reusable instructions, templates, and scripts that teach agents your processes. - [Brain](https://docs.orchestrivo.com/core-concepts/brain.md): Brain is your company knowledge base for agents. Connect your tools once, and your agents can search everything your team knows. - [Agent artifacts (files)](https://docs.orchestrivo.com/core-concepts/agent_artifacts.md): Preview, version, share, and host the files your agents generate - [Live artifacts](https://docs.orchestrivo.com/core-concepts/live_artifacts.md): HTML pages that load live data, take actions, call AI models, and run your agents for whoever opens them - [Agent browser](https://docs.orchestrivo.com/core-concepts/agent_browser.md): Browse websites, use saved logins, and review or take over your agent’s browser. - [Browser logins and profiles](https://docs.orchestrivo.com/core-concepts/browser_logins_and_profiles.md): Let your agent sign in to websites without seeing your password: saved logins with 2FA, browser profiles that keep sessions across tasks, imported sign-ins, and 1Password. - [Using agents in Slack](https://docs.orchestrivo.com/core-concepts/agents_slack.md) - [Custom Slack app integration](https://docs.orchestrivo.com/core-concepts/custom_slack_app.md) - [Using agents in Microsoft Teams](https://docs.orchestrivo.com/core-concepts/agents_teams.md): Connect your Orchestrivo agents to Microsoft Teams channels so your team can chat with AI-powered assistants where they already work. - [Agent email inbox](https://docs.orchestrivo.com/core-concepts/agents_email.md): Send requests and attachments to your agent’s dedicated email inbox. - [Hosted pages](https://docs.orchestrivo.com/core-concepts/hosted_pages.md): Give your agent a standalone page on orchestrivoagents.com that anyone can open directly. - [Connectors](https://docs.orchestrivo.com/core-concepts/credentials.md) - [Agent triggers](https://docs.orchestrivo.com/core-concepts/agent_triggers.md): Run your agents automatically on a schedule or in response to external events like emails, Slack messages, and more. - [Create triggers with AI](https://docs.orchestrivo.com/core-concepts/ai_trigger_creation.md): Let AI build custom polling triggers that monitor any combination of connected services and fire your agent when conditions are met. - [Organization and teams](https://docs.orchestrivo.com/core-concepts/teams.md) - [User roles](https://docs.orchestrivo.com/core-concepts/organization_user_roles.md): Composable organization and team roles that determine what each member can do in Orchestrivo. - [Profile settings](https://docs.orchestrivo.com/core-concepts/profile_settings.md): Your personal details, preferences, and desktop notifications - [Organization skills](https://docs.orchestrivo.com/core-concepts/organization_skills.md): Centrally manage skills for your whole organization, and keep them in sync with a GitHub repository. - [Support access](https://docs.orchestrivo.com/core-concepts/support_access.md): Let Orchestrivo staff read or edit your organization while they help you, and turn it off at any time. - [Credits](https://docs.orchestrivo.com/core-concepts/credits.md): How Orchestrivo bills agent chats - [Subscription management](https://docs.orchestrivo.com/core-concepts/subscription_management.md) - [Rate limits](https://docs.orchestrivo.com/core-concepts/rate_limits.md): Understand concurrency limits for agents, how they are calculated, and what happens when you hit them. - [AI models](https://docs.orchestrivo.com/core-concepts/ai_models.md) - [Enterprise features](https://docs.orchestrivo.com/enterprise-features/overview.md): Identity, governance, security, and admin controls available on the Orchestrivo Enterprise plan. - [Agent default settings](https://docs.orchestrivo.com/enterprise-features/agent_default_settings.md) - [Connector activity](https://docs.orchestrivo.com/enterprise-features/app_activity.md): Monitor tool calls, MCP interactions, and integration usage across your organization with real-time activity logs. - [Hosted MCPs](https://docs.orchestrivo.com/enterprise-features/hosted_mcps.md): Deploy, manage, and monitor custom MCP servers directly from GitHub repositories with full lifecycle management. - [Proxied MCPs](https://docs.orchestrivo.com/enterprise-features/proxied_mcps.md): Connect external MCP servers through a managed proxy for centralized monitoring, access control, and security. - [Custom MCP servers](https://docs.orchestrivo.com/nodes/mcp/custom_mcp_servers.md): Connect your own MCP servers to Orchestrivo for extended AI capabilities. - [No-auth connectors](https://docs.orchestrivo.com/nodes/mcp/no_auth_connectors.md) - [Snowflake OAuth configuration](https://docs.orchestrivo.com/nodes/integrations/snowflake-oauth-config.md) - [Snowflake key-pair configuration](https://docs.orchestrivo.com/nodes/integrations/snowflake-keypair-config.md) - [Snowflake PAT configuration](https://docs.orchestrivo.com/nodes/integrations/snowflake-pat-config.md) - [NetSuite OAuth configuration](https://docs.orchestrivo.com/nodes/integrations/netsuite-oauth-config.md) - [BigQuery Workload Identity Federation](https://docs.orchestrivo.com/nodes/integrations/bigquery-workload-identity-federation.md): Connect BigQuery to Orchestrivo without OAuth or static service-account keys using GCP Workload Identity Federation. - [Okta integration](https://docs.orchestrivo.com/previews/core-concepts/okta-integration.md): Register Orchestrivo as an application in Okta so organization members authenticate Orchestrivo-connected services through Okta. - [Enterprise admin starter kit](https://docs.orchestrivo.com/previews/enterprise-features/onboarding.md): Set up your organization, run a small pilot, and help your first department get value from an agent. - [SSO: SAML, OIDC & SCIM](https://docs.orchestrivo.com/previews/enterprise-features/sso_saml_oidc_scim.md): Single sign-on and automatic user provisioning with Okta, Microsoft Entra ID, JumpCloud, Google Identity, and Ping Identity. - [Organization login page](https://docs.orchestrivo.com/previews/enterprise-features/login_page.md): Customize your organization’s sign-in URL, branding, and allowed sign-in methods, then verify access before rolling it out. - [SAML with Okta](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/saml-with-okta.md): Configure SAML single sign-on to Orchestrivo with Okta - [SCIM with Okta](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/scim-with-okta.md): Configure SCIM user provisioning for Orchestrivo with Okta - [SAML with Entra](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/saml-with-entra.md): Configure SAML single sign-on to Orchestrivo with Microsoft Entra ID (formerly Azure Active Directory) - [SCIM with Entra](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/scim-with-entra.md): Configure SCIM user provisioning for Orchestrivo with Microsoft Entra ID (formerly Azure Active Directory) - [SAML with JumpCloud](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/saml-with-jumpcloud.md): Configure SAML single sign-on to Orchestrivo with JumpCloud - [SAML with Google Identity](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/saml-with-google.md): Configure SAML single sign-on to Orchestrivo with Google Identity - [SAML with Ping Identity](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/saml-with-ping.md): Configure SAML single sign-on to Orchestrivo with PingOne - [OIDC with Okta](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/oidc-with-okta.md): Configure OIDC single sign-on to Orchestrivo with Okta - [Cross App Access with Okta](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/cross-app-access-with-okta.md): Set up Okta Cross App Access so members use Slack, Asana, Zoom, Supabase, Canva, and Granola in Orchestrivo through their Okta connection - [Okta configuration guide](https://docs.orchestrivo.com/previews/enterprise-features/idp-guides/okta-oin-configuration-guide.md): Set up Okta single sign-on to Orchestrivo from the Okta Integration Network - [Custom roles](https://docs.orchestrivo.com/previews/enterprise-features/user_groups.md): Control which connectors, tools, and AI models each group of members can access. - [Approvers](https://docs.orchestrivo.com/previews/enterprise-features/approvers.md): Choose who handles access requests from members, for features, credit limits, models, connectors, and organization roles. - [Organization service accounts for Slack agents](https://docs.orchestrivo.com/previews/enterprise-features/slack_agent_access.md): Let Slack members without a Orchestrivo account run the agents you approve. - [Usage data export](https://docs.orchestrivo.com/previews/enterprise-features/organization_data_export.md): Export your organization's usage data for your own analysis. - [Outbound webhooks](https://docs.orchestrivo.com/previews/enterprise-features/organization_webhooks.md): Get notified at your own endpoint when someone joins your organization - [Audit logging](https://docs.orchestrivo.com/previews/enterprise-features/audit_logging.md): Track user actions across your organization for security and compliance. - [AI model governance & configuration](https://docs.orchestrivo.com/previews/enterprise-features/ai_model_control.md): Control which AI models your organization can use and which API keys those calls run on. - [Organization insights](https://docs.orchestrivo.com/previews/enterprise-features/organization_insights.md): Dashboards and an analytics agent for adoption, credit spend, and outcomes across your organization - [Organization evaluations](https://docs.orchestrivo.com/previews/enterprise-features/organization_evaluations.md): Grade tasks from many agents against one set of criteria. - [Managed tunnels](https://docs.orchestrivo.com/previews/enterprise-features/managed_tunnels.md): Securely connect MCP servers running inside your private network to Orchestrivo, without opening any inbound ports. - [Static egress IPs](https://docs.orchestrivo.com/previews/enterprise-features/static_egress_ips.md): Fixed outbound IP addresses for firewall and allowlist configuration. - [Connector policies](https://docs.orchestrivo.com/previews/enterprise-features/app-policies/overview.md): Govern how your organization uses connectors inside Orchestrivo: block risky tool calls, require corporate email domains, and claim provider workspaces. - [App rules](https://docs.orchestrivo.com/previews/enterprise-features/app-policies/app-rules.md): Block, tag, or require approval for specific third-party app tool calls at the organization or agent level. - [Domain restrictions](https://docs.orchestrivo.com/previews/enterprise-features/app-policies/domain-restrictions.md): Require OAuth connections to a given app to use an email address from a domain your organization controls. - [App claims](https://docs.orchestrivo.com/previews/enterprise-features/app-policies/app-claims.md): Claim a provider workspace, such as a specific Slack workspace, Salesforce org, or Notion workspace, for your organization so only your members can connect to it from Orchestrivo. - [Enable agent-owned credentials](https://docs.orchestrivo.com/previews/help/sharing/enable-agent-owned-credentials.md): Grant the Agent-owned credentials feature on a custom role so people can pin one account or connection that everyone with access to an agent uses. - [Skills vs app rules](https://docs.orchestrivo.com/previews/help/skills/skills-vs-app-rules.md): When to teach an agent a process with a skill, and when to constrain its tool calls with an app rule. - [Authentication](https://docs.orchestrivo.com/api-reference/authentication.md) - [OAuth 2.0](https://docs.orchestrivo.com/api-reference/oauth.md) - [Getting started](https://docs.orchestrivo.com/api-reference/getting-started.md): Use the Orchestrivo API to create agents, start chat sessions, and trigger automations programmatically. - [List agents](https://docs.orchestrivo.com/api-reference/agents/list-agents.md): List agents the caller has access to. Filter by team, search by name, or narrow to agents that use a specific tool or trigger. Results can be sorted with `sort_order` and paginated by sending `page_size` and/or `cursor`. Send `summary=true` to receive the lightweight `AgentSummary` shape instead of… - [Create agent](https://docs.orchestrivo.com/api-reference/agents/create-agent.md): Create a new agent. The authenticated caller must have permission to create agents on the target team. - [Retrieve agent](https://docs.orchestrivo.com/api-reference/agents/retrieve-agent.md): Retrieve an agent with its whole configuration: settings, tools, native abilities, skills, knowledge sources, triggers and the current `version`. Sections the caller's agent role hides are omitted. - [Update agent](https://docs.orchestrivo.com/api-reference/agents/update-agent.md): Update an agent's settings. Only fields in the body change; `metadata` merges section by section (objects merge, arrays and scalars replace), except `metadata.model_settings`, which replaces the saved object whole. Send every model-settings field you want to keep. - [Set agent incognito](https://docs.orchestrivo.com/api-reference/agents/set-agent-incognito.md): Set whether every new task on a custom agent must run incognito. The caller needs update access on the agent. - [Delete agent](https://docs.orchestrivo.com/api-reference/agents/delete-agent.md): Delete a custom agent. The agent disappears from every list and its triggers stop. Platform agents (`orchestrivoassistant`, `analytics`) cannot be deleted. - [Update agent abilities](https://docs.orchestrivo.com/api-reference/agents/update-agent-abilities.md): Turn the agent's native abilities on or off and set their options: Web Search, Web Fetch, Image Generation, Search Past Conversations, Ask Question, Manage Evaluations, Chat Widgets, and Browser. - [Attach or detach agent skills](https://docs.orchestrivo.com/api-reference/agents/update-agent-skills.md): Attach and/or detach skills on an agent using deltas. This is **not** a replace-list: skills you don't mention are left untouched. - [List agent MCP servers](https://docs.orchestrivo.com/api-reference/agents/list-agent-mcp-servers.md): List the MCP servers (connectors) attached to an agent. Sensitive fields such as `secret_id` and `mcp_server_url` are scrubbed from the response. - [Attach or update an agent MCP server](https://docs.orchestrivo.com/api-reference/agents/attach-agent-mcp-server.md): Attach a connector to an agent, or update its settings if it is already attached (upsert). - [Detach an agent MCP server](https://docs.orchestrivo.com/api-reference/agents/detach-agent-mcp-server.md): Detach an MCP server (connector) from an agent. This is idempotent — detaching a server that isn't attached returns `detached: false` rather than an error. - [List agent knowledge sources](https://docs.orchestrivo.com/api-reference/agents/list-agent-knowledge-sources.md): Brain sources attached to the agent, with the scope each one is read through. The same list is inlined on `GET /agents/{agent_id}` as `knowledge_sources`. - [Attach or scope an agent knowledge source](https://docs.orchestrivo.com/api-reference/agents/attach-agent-knowledge-source.md): Attach a Brain source to the agent, or change its scope if it is already attached. Idempotent: sending the same scope twice reports `already_present`. - [Detach an agent knowledge source](https://docs.orchestrivo.com/api-reference/agents/detach-agent-knowledge-source.md): Detach a Brain source from the agent. Idempotent; detaching a source that is not attached answers with `detached` set to `false`. - [Attach a subagent](https://docs.orchestrivo.com/api-reference/agents/attach-agent-subagent.md): Let the agent delegate to another agent. Idempotent: attaching an agent that is already allowed returns `changed: false`. - [Detach a subagent](https://docs.orchestrivo.com/api-reference/agents/detach-agent-subagent.md): Stop the agent delegating to `subagent_id`. Idempotent. - [List agent triggers](https://docs.orchestrivo.com/api-reference/agents/list-agent-triggers.md): Triggers on the agent, newest first, using the shared cursor contract (`page_size`, `cursor`, `next_cursor`). Every trigger type is listed; only `schedule` and `webhook` can be created or edited through the API. - [Create an agent trigger](https://docs.orchestrivo.com/api-reference/agents/create-agent-trigger.md): Create a `schedule` or `webhook` trigger. - [Update an agent trigger](https://docs.orchestrivo.com/api-reference/agents/update-agent-trigger.md): Only the fields you send change. Any trigger can be renamed, reworded, paused and resumed (`name`, `prompt`, `enabled`, `max_failures`). - [Delete an agent trigger](https://docs.orchestrivo.com/api-reference/agents/delete-agent-trigger.md): Delete a `schedule` or `webhook` trigger. Other trigger types answer `400 trigger_type_not_editable`. Team API keys are not accepted. - [Get a webhook trigger's URL](https://docs.orchestrivo.com/api-reference/agents/get-agent-trigger-webhook-url.md): The inbound URL for a `webhook` trigger. It embeds the trigger's secret, so it is returned here and on create only, never in lists or agent reads. - [List agent app rules](https://docs.orchestrivo.com/api-reference/agents/list-agent-app-rules.md): Connector rules the agent has authored for itself (which tools it may call on a connector, and when). Read only; rules are created by the agent, not through the API. - [List agent versions](https://docs.orchestrivo.com/api-reference/agents/list-agent-versions.md): List the immutable versions of an agent, newest first. Each entry is a point-in-time snapshot of the agent's configuration. - [Retrieve agent version](https://docs.orchestrivo.com/api-reference/agents/retrieve-agent-version.md): Retrieve one immutable agent version: its full configuration (`composition`) plus the structured `changes` relative to the version before it. Use it to export an agent's configuration or to audit what changed between versions. - [List sessions](https://docs.orchestrivo.com/api-reference/sessions/list-sessions.md): List sessions for an agent with cursor-based pagination, optional filtering, and search. - [Create session](https://docs.orchestrivo.com/api-reference/sessions/create-session.md): Create a new session for an agent. When `input` is provided, the message is enqueued and the agent begins processing — the response returns `202` with the session in `processing` or `queued` state. - [Retrieve session](https://docs.orchestrivo.com/api-reference/sessions/retrieve-session.md): Retrieve a session by ID, including its messages, current state, agent metadata, and participants. - [Get session access](https://docs.orchestrivo.com/api-reference/sessions/get-session-access.md): Read the people, teams, organization, and link access for a session. The caller must be allowed to view its access settings. - [Update session access](https://docs.orchestrivo.com/api-reference/sessions/update-session-access.md): Add or remove people, teams, or organization access, or change link access for a session. - [Send message](https://docs.orchestrivo.com/api-reference/sessions/send-message.md): Append a user message to an existing session. - [Upload session file](https://docs.orchestrivo.com/api-reference/sessions/upload-session-file.md): Upload a file into a session's input namespace so it can be attached to a message. The response returns the stored path — pass it as `file_name` in the `attachments` array when sending a message on the same session. - [Resolve approvals](https://docs.orchestrivo.com/api-reference/sessions/resolve-approvals.md): Answer pending asks on a session that is paused in the `approval_required` state — tool approvals, human input requests, and checkpoints. - [Queue message](https://docs.orchestrivo.com/api-reference/sessions/queue-message.md): Add a message to a session's queue instead of interrupting the agent. Queued messages are sent automatically, in order. An eligible idle, completed, or failed session starts a turn immediately; a busy session consumes the message through its existing queue. - [List queued messages](https://docs.orchestrivo.com/api-reference/sessions/list-queued-messages.md): List the messages waiting in a session's queue, in the order they will be sent. Queued messages are delivered automatically when the session can run. - [Update queued message](https://docs.orchestrivo.com/api-reference/sessions/update-queued-message.md): Replace the content of a message that is still waiting in the session's queue. - [Delete queued message](https://docs.orchestrivo.com/api-reference/sessions/delete-queued-message.md): Remove a message from the session's queue before it is sent. - [Send queued message now](https://docs.orchestrivo.com/api-reference/sessions/send-queued-message.md): Send a queued message immediately instead of waiting for the agent to finish its current turn. Any in-progress run is aborted, the queued message is appended to the transcript, and the agent starts processing it. - [Rename session](https://docs.orchestrivo.com/api-reference/sessions/rename-session.md): Rename a session. `name` is the only mutable field; it is trimmed and must be between 1 and 256 characters after trimming. - [Cancel session](https://docs.orchestrivo.com/api-reference/sessions/cancel-session.md): Cancel an in-progress session. If the session is currently `processing` or `queued`, any running stream is aborted and the session is transitioned to `failed`. If the session is already `completed` or `failed`, its current state is returned unchanged. - [List skills](https://docs.orchestrivo.com/api-reference/skills/list-skills.md): List skills the caller has access to. Filter by team, search by name, or narrow to a specific creator, related MCP server, or agent. - [Create skill](https://docs.orchestrivo.com/api-reference/skills/create-skill.md): Upload a skill package and create a new skill. The package must include a `SKILL.md` with `name` and `description` frontmatter; uploads may be a single `.md` file (stored as `SKILL.md`), or a `.zip` / `.skill` archive containing `SKILL.md` at its root. The initial version is created automatically. M… - [Update skill](https://docs.orchestrivo.com/api-reference/skills/update-skill.md): Replace a skill's files with a new upload. Reparses `SKILL.md` to update the skill's `name`, `description`, and `metadata`, and creates a new version. Maximum upload size is 10 MB. - [Get skill access](https://docs.orchestrivo.com/api-reference/skills/get-skill-access.md): Read the people, teams, organization, and link access for a skill. The caller must be allowed to view its access settings. - [Update skill access](https://docs.orchestrivo.com/api-reference/skills/update-skill-access.md): Add or remove people, teams, or organization access, or change link access for a skill. - [Delete skill](https://docs.orchestrivo.com/api-reference/skills/delete-skill.md): Permanently delete a skill. This is a soft-delete — the skill will no longer appear in listings or be usable by agents. - [Download skill](https://docs.orchestrivo.com/api-reference/skills/download-skill.md): Generate a signed URL to download a skill's contents as a `.skill` archive (ZIP). When `version_id` is provided, returns that exact version; otherwise returns the current draft. - [List artifacts](https://docs.orchestrivo.com/api-reference/artifacts/list-artifacts.md): List artifacts (files) produced by an agent. Optionally scope to a specific session, search by filename, sort, and paginate. Deleted files are excluded from the results. - [Get artifact access](https://docs.orchestrivo.com/api-reference/artifacts/get-artifact-access.md): Read the people, teams, organization, and link access for an artifact. The caller must be allowed to view its access settings. - [Update artifact access](https://docs.orchestrivo.com/api-reference/artifacts/update-artifact-access.md): Add or remove people, teams, or organization access, or change link access for an artifact. - [Set an artifact password](https://docs.orchestrivo.com/api-reference/artifacts/update-artifact-password.md): Set the password protecting an artifact. Passwords must be 6–256 characters. - [Download artifact](https://docs.orchestrivo.com/api-reference/artifacts/download-artifact.md): Returns a signed download URL for an artifact, plus its filename, media type, and size. Follow `download_url` to fetch the file bytes. - [List MCP servers](https://docs.orchestrivo.com/api-reference/mcp/list-servers.md): Return the catalog of MCP servers visible to the caller — Orchestrivo-hosted (`gumcp_server`), user-deployed OrchestrivoControls (`orchestrivocontrols_server`), and custom (`mcp_server`) — along with each server's connection state. - [Retrieve an MCP server](https://docs.orchestrivo.com/api-reference/mcp/retrieve-server.md): Return a single MCP server. The response populates `allowed_tool_call_ids` with the tool call IDs the caller is permitted to invoke on this server. - [List connected accounts](https://docs.orchestrivo.com/api-reference/mcp/list-accounts.md): Discover the accounts available for a connector call. - [List MCP server tools](https://docs.orchestrivo.com/api-reference/mcp/list-tools.md): Return the tools exposed by an MCP server. When the server is not in `connected` state, `tools` is empty and `orchestrivo_auth_url` is returned so the caller can prompt the user to authenticate. - [Call MCP tools](https://docs.orchestrivo.com/api-reference/mcp/call-tool.md): Execute a batch of 1–5 MCP tool calls. Calls run concurrently and each result reports its own `status`. - [List MCP server resources](https://docs.orchestrivo.com/api-reference/mcp/list-resources.md): Return resources exposed by the MCP server. When it is not `connected`, `resources` is empty and `orchestrivo_auth_url` lets the caller prompt for authentication. Tokens scoped to a tool list return an empty resource list; tool access does not grant resource access. - [Read MCP server resource](https://docs.orchestrivo.com/api-reference/mcp/read-resource.md): Read one resource by `uri`. Each content item is either `text` or a base64 `blob`, never both. A sandbox token restricted to a tool list cannot read resources and receives `403` with code `resource_not_allowed`. - [List MCP server prompts](https://docs.orchestrivo.com/api-reference/mcp/list-prompts.md): Return the prompt templates an MCP server exposes, fetched live from the server. When the server is not `connected`, `prompts` is empty and `orchestrivo_auth_url` is returned. - [Get MCP server prompt](https://docs.orchestrivo.com/api-reference/mcp/get-prompt.md): Render one prompt template with arguments and return its messages. - [List browser profiles](https://docs.orchestrivo.com/api-reference/browser-profiles/list-browser-profiles.md): List the browser profiles you own, or a team's profiles with `team_id`. A browser profile holds the sign-ins an agent's Browser ability uses. Cookie values are never returned; each profile lists its sites and cookie counts. - [Import cookies into a browser profile](https://docs.orchestrivo.com/api-reference/browser-profiles/import-cookies.md): Add sign-in cookies to a browser profile. This is what `orchestrivo browser import-logins` calls. Send the cookies in Chrome extension (`chrome.cookies.Cookie`) or Chrome DevTools Protocol `Cookie` shape. - [Query personal wiki](https://docs.orchestrivo.com/api-reference/wiki/query.md): Read the authenticated user's personal wiki cards. Send `{}` to list every card, a `type` to list the cards of that type, or `type` and `entity_key` to read one card. - [List evaluations](https://docs.orchestrivo.com/api-reference/evaluations/list-evaluations.md): Returns a cursor-paginated list of evaluation results for a specific agent, newest first. Only completed and failed evaluations are returned unless `status` selects another state. - [Retrieve evaluation](https://docs.orchestrivo.com/api-reference/evaluations/retrieve-evaluation.md): Retrieve a single evaluation result by ID. The evaluation must belong to the specified agent. - [Get evaluation metrics](https://docs.orchestrivo.com/api-reference/evaluations/get-metrics.md): Returns aggregated grade and tag counts for an agent's evaluations over a time window. Useful for dashboards and reporting on agent quality trends. - [Run evaluations](https://docs.orchestrivo.com/api-reference/evaluations/run-evaluations.md): Grades up to 200 of the agent's finished sessions with its own evaluation configuration. - [Get evaluation config](https://docs.orchestrivo.com/api-reference/evaluations/get-config.md): Retrieve the current evaluation configuration for an agent, including criteria, tags, data points, and sentiment settings. - [Update evaluation config](https://docs.orchestrivo.com/api-reference/evaluations/update-config.md): Partially update the evaluation configuration for an agent. Omitted fields keep their current value. Provided list fields (criteria, tags, data_points) replace that list entirely. - [List evaluations](https://docs.orchestrivo.com/api-reference/organization-evaluations/list-evaluations.md): Cursor-paginated list of an organization's evaluations with their targets, coverage, and result rollups. Requires the `organization:manage_evaluations` permission (Enterprise plan). - [Create evaluation](https://docs.orchestrivo.com/api-reference/organization-evaluations/create-evaluation.md): Creates an organization evaluation. A new evaluation has no targets, so it cannot start enabled: set targets with `PUT /evaluations/{evaluation_id}/targets`, then enable it with `PATCH /evaluations/{evaluation_id}`. - [Retrieve evaluation](https://docs.orchestrivo.com/api-reference/organization-evaluations/retrieve-evaluation.md): Returns one evaluation with its rubric, targets, current coverage, and result rollup. - [Update evaluation](https://docs.orchestrivo.com/api-reference/organization-evaluations/update-evaluation.md): Partial update. Only the fields you send change. `config` is merged field by field; a list you send (`criteria`, `tags`, `data_points`) replaces that list wholesale. `description: null` clears the description. - [Delete evaluation](https://docs.orchestrivo.com/api-reference/organization-evaluations/delete-evaluation.md): Deletes the evaluation. It stops running and disappears from lists; results it already produced stay attached to their sessions. - [Set evaluation targets](https://docs.orchestrivo.com/api-reference/organization-evaluations/set-targets.md): Replaces the full set of targets — who the evaluation grades. Targets expand to agents live: `organization` covers every agent in the organization, `team` every agent a team owns, `user` a member's personal agents, `agent` one agent. Removing the last target pauses an enabled evaluation; `enabled` i… - [Run evaluation on sessions](https://docs.orchestrivo.com/api-reference/organization-evaluations/run-evaluation.md): Grades up to 200 existing sessions with this evaluation. Grading is asynchronous: each accepted session gets a result with `status: queued`; poll it with `GET /evaluations/{evaluation_id}/results/{result_id}` until it is `completed` or `failed`. - [List evaluation results](https://docs.orchestrivo.com/api-reference/organization-evaluations/list-results.md): Cursor-paginated results for one evaluation across every agent it grades, newest first. Each session appears once with its latest result; queued and in-progress results are included so a run can be followed to completion. - [Retrieve evaluation result](https://docs.orchestrivo.com/api-reference/organization-evaluations/retrieve-result.md): One result, including per-criterion outcomes, extracted data points, and applied tags. Poll this after `POST /evaluations/{evaluation_id}/run` until `status` is `completed` or `failed`. - [Get evaluation metrics](https://docs.orchestrivo.com/api-reference/organization-evaluations/get-metrics.md): Grade counts for one evaluation over a trailing window (default 30 days, 1–365). - [Get evaluation options](https://docs.orchestrivo.com/api-reference/organization-evaluations/get-options.md): Allowed values for evaluation fields and filters — session types, criterion types and priorities, data point types, frequencies, grades, statuses, target types, skip reasons — plus size limits. Use these instead of hardcoding enums. - [Search Company Brain](https://docs.orchestrivo.com/api-reference/brain/search.md): Run a hybrid (semantic + keyword) search across the knowledge sources indexed in your [Company Brain](/core-concepts/brain) and return the most relevant, ranked snippets with citations. - [List sources](https://docs.orchestrivo.com/api-reference/brain/list-sources.md): List the [Company Brain](/core-concepts/brain) sources the authenticated user can see: personal sources, plus team and organization sources shared with them. Every source type is listed, including ones connected in the app such as Notion or Google Drive. - [Create source](https://docs.orchestrivo.com/api-reference/brain/create-source.md): Create a file-upload source. Only `direct_file_uploads` sources can be created through the API; connected sources such as Notion or Google Drive are set up in the Orchestrivo app because they need an account connection. - [Retrieve source](https://docs.orchestrivo.com/api-reference/brain/get-source.md): Fetch one source the authenticated user can see. - [Delete source](https://docs.orchestrivo.com/api-reference/brain/delete-source.md): Delete a source, every file in it, and everything it contributed to search. This cannot be undone. - [List files](https://docs.orchestrivo.com/api-reference/brain/list-files.md): List the files in a file-upload source with their indexing status. Each file carries the `sha256` of its bytes, so a client can compare a local folder against the source and upload only what changed. - [Upload files](https://docs.orchestrivo.com/api-reference/brain/upload-files.md): Upload up to 25 files as `multipart/form-data` parts named `files`. Accepted types are PDF, Word, PowerPoint, Excel, and text formats (`.txt`, `.md`, `.html`, `.csv`, `.rtf`), each up to 25 MB. - [Delete file](https://docs.orchestrivo.com/api-reference/brain/delete-file.md): Remove a file from the source and from search. - [Retrieve estimate](https://docs.orchestrivo.com/api-reference/brain/get-estimate.md): The latest credit estimate for a source created with `require_approval`. `estimate` is `null` until the first upload has produced a run; poll until `estimate.status` is `paused_for_approval`, then call [Approve source](/api-reference/brain/approve-source). `estimated_credits` is rounded up to the ne… - [Approve source](https://docs.orchestrivo.com/api-reference/brain/approve-source.md): Approve a `draft` source. It becomes `active`, the paused estimate run resumes as a real indexing run, and credits are charged. Later uploads index without another approval. - [List teams](https://docs.orchestrivo.com/api-reference/teams/list-teams.md): List the teams the authenticated user is a member of, as `id` and `name`. The response is the whole list: there is no pagination, cursor or filter. Deleted teams are omitted. - [List models](https://docs.orchestrivo.com/api-reference/models/list-models.md): List chat models, preset model chains, and decision models in display groups for the caller. Models with `supports_decisions: true` can use `POST /decisions`. `is_classifier_model: true` means decisions-only, with no chat path. GPT-6 Luna (`gpt-6-luna`) supports both decisions and chat. Model restri… - [Route a message to a model](https://docs.orchestrivo.com/api-reference/models/route-model.md): Ask Orchestrivo Chew — the model router behind **Auto** — which model it would use for a given message, and why. Chew is a router, not a model: `router` is always `orchestrivo-chew`, and the concrete model it selected is `route.model`. - [Create chat completion](https://docs.orchestrivo.com/api-reference/chat-completions/create-completion.md): Run one chat completion on any model Orchestrivo supports (Anthropic, OpenAI, Google Gemini, OpenRouter routes). The request and response use the OpenRouter chat completions schema, which extends OpenAI's. An OpenAI-style client works unchanged. - [Create decision](https://docs.orchestrivo.com/api-reference/models/create-decision.md): Classify or score information with a model marked `supports_decisions: true`. Jev uses OpenRouter; GPT-6 Luna uses OpenAI directly. Both accept the same question schema. The endpoint does not select a fallback model. - [Upload file](https://docs.orchestrivo.com/api-reference/file-operations/upload-file.md): Upload a file to a location the caller can write. Team API keys cannot upload chat or personal agent files; use a personal API key with access to the target. These refusals use `personal_credential_required`. Protected chat and agent folder locations cannot be replaced through this endpoint (`file_l… - [Upload multiple files](https://docs.orchestrivo.com/api-reference/file-operations/upload-files.md): Upload files to locations the caller can write. Team API keys cannot upload chat or personal agent files; use a personal API key with access to the targets. These refusals use `personal_credential_required`. Protected chat and agent folder locations cannot be replaced through this endpoint (`file_lo… - [Download file](https://docs.orchestrivo.com/api-reference/file-operations/download-file.md): Download files the caller can access. Team API keys cannot open chat or personal agent files; use a personal API key for those files. These refusals use `personal_credential_required`. - [Download multiple files](https://docs.orchestrivo.com/api-reference/file-operations/download-files.md): Download files the caller can access. Team API keys cannot open chat or personal agent files; use a personal API key for those files. These refusals use `personal_credential_required`. - [List organizations](https://docs.orchestrivo.com/api-reference/organization/list-organizations.md): Returns the organization the authenticated user belongs to. Use its `id` as `organization_id` on the evaluation endpoints. - [Retrieve audit logs](https://docs.orchestrivo.com/api-reference/organization/get-audit-logs.md): This endpoint retrieves audit logs for all users in an organization for a specified time period. - [Manage workspace users](https://docs.orchestrivo.com/api-reference/organization/manage-workspace-users.md): This endpoint allows organization administrators to add or remove users from a workspace. - [Manage custom role users](https://docs.orchestrivo.com/api-reference/organization/manage-permission-group-users.md): This endpoint allows organization administrators to add or remove users from a custom role (formerly "permission group"). Adding a user to a role does not remove them from any other role they belong to. - [List custom role credit limits](https://docs.orchestrivo.com/api-reference/organization/list-role-credit-limits.md): This endpoint lists every active custom role in an organization together with its monthly credit limit, so external systems can manage credit limits programmatically. A `monthly_credit_limit` of `null` means the role sets no limit of its own. The limit applies to each member of the role individually… - [Get custom role credit limit](https://docs.orchestrivo.com/api-reference/organization/get-role-credit-limit.md): This endpoint returns the monthly credit limit of one custom role. A `monthly_credit_limit` of `null` means the role sets no limit of its own. - [Set custom role credit limit](https://docs.orchestrivo.com/api-reference/organization/set-role-credit-limit.md): This endpoint sets or clears the monthly credit limit of a custom role. - [Export data](https://docs.orchestrivo.com/api-reference/organization/export-data.md): This endpoint allows enterprise organization administrators to create and initiate a comprehensive data export for their organization or specific workspaces. - [Get data export status](https://docs.orchestrivo.com/api-reference/organization/export-status.md): This endpoint retrieves the status of a data export job and optionally downloads the export file (as CSV) if the export has completed successfully. - [Python SDK](https://docs.orchestrivo.com/sdk/python.md): Run Orchestrivo agents, chat completions, MCP tools, Company Brain, skills, and artifacts from your own Python code. - [JavaScript SDK](https://docs.orchestrivo.com/sdk/javascript.md) - [Orchestrivo for terminal](https://docs.orchestrivo.com/cli/overview.md): Drive Orchestrivo agents, sessions, chat completions, MCP servers, Company Brain, skills, and artifacts from your shell. - [Authentication](https://docs.orchestrivo.com/cli/authentication.md): Sign in with OAuth or an API key. The CLI stores credentials in your OS keychain. - [Agents](https://docs.orchestrivo.com/cli/agents.md): List, inspect, create, and update agents from the terminal. - [Sessions](https://docs.orchestrivo.com/cli/sessions.md): Start agent conversations, send follow-ups, and cancel running sessions. - [Evaluations](https://docs.orchestrivo.com/cli/evaluations.md): Create organization evaluations, choose which agents they grade, and run them over past sessions. - [Chat](https://docs.orchestrivo.com/cli/chat.md): Send chat completions to any Orchestrivo-supported model from the terminal. - [Decisions](https://docs.orchestrivo.com/cli/decisions.md): Ask decision models structured questions about a state. - [Models](https://docs.orchestrivo.com/cli/models.md): Discover available models and ask Orchestrivo Chew to choose one for a task. - [MCP servers](https://docs.orchestrivo.com/cli/mcp.md): Explore the MCP servers available to your account and execute their tools. - [Brain](https://docs.orchestrivo.com/cli/brain.md): Search your Company Brain and keep a folder of files synced into it from the terminal. - [Personal wiki](https://docs.orchestrivo.com/cli/wiki.md): Read personal wiki cards from the terminal. - [Skills](https://docs.orchestrivo.com/cli/skills.md): Upload, update, and download agent skills as files. - [Artifacts](https://docs.orchestrivo.com/cli/artifacts.md): List and download files produced by agents. - [Browser profiles](https://docs.orchestrivo.com/cli/browser.md): Create, inspect, update, and delete personal browser profiles. - [Coding-agent plugin](https://docs.orchestrivo.com/cli/plugin.md): Install bundled Orchestrivo instructions for coding agents. - [Managed skill sync](https://docs.orchestrivo.com/cli/sync.md): Synchronize managed Orchestrivo skills into detected coding-agent targets. - [MCP server](https://docs.orchestrivo.com/mcp-server/overview.md): Connect to the Orchestrivo MCP server from Claude, Cursor, VS Code, and other MCP-compatible clients. - [Connect a client](https://docs.orchestrivo.com/mcp-server/setup.md): Connect Claude, Claude Code, Cursor, VS Code, Windsurf, or the Orchestrivo CLI to the Orchestrivo MCP server. - [MCP vs. REST API](https://docs.orchestrivo.com/mcp-server/mcp-vs-rest-api.md): Compare the capabilities available through Orchestrivo's MCP server and REST API. - [Use Orchestrivo as your auth layer](https://docs.orchestrivo.com/mcp-server/centralized-auth.md): Call Gmail, Slack, Linear, and custom MCP server tools through Orchestrivo, with your organization's connector governance applied. - [Agent tools](https://docs.orchestrivo.com/mcp-server/tools/agents.md): Create and manage agents, their abilities, skills, MCP servers, knowledge sources, subagents, triggers, models, and versions. - [Agent session tools](https://docs.orchestrivo.com/mcp-server/tools/sessions.md): Start agent sessions, send messages, inspect results, and manage conversations. - [Evaluation tools](https://docs.orchestrivo.com/mcp-server/tools/evaluations.md): Configure agent and organization evaluations, run grades, and review evaluation results and metrics. - [Skill tools](https://docs.orchestrivo.com/mcp-server/tools/skills.md): Create, update, find, and download reusable skills for Orchestrivo agents. - [Artifact tools](https://docs.orchestrivo.com/mcp-server/tools/artifacts.md): Find and download artifacts created by agent sessions. - [Connected app tools](https://docs.orchestrivo.com/mcp-server/tools/connected-apps.md): Browse and call tools, resources, and prompts from connected MCP servers. - [Company Brain tool](https://docs.orchestrivo.com/mcp-server/tools/brain.md): Search relevant content across your Company's Brain knowledge sources. - [Organization tools](https://docs.orchestrivo.com/mcp-server/tools/organization.md): List organizations, manage teams and custom roles, set credit limits, retrieve audit logs, and export organization data. - [Documentation tools](https://docs.orchestrivo.com/mcp-server/tools/documentation.md): Search Orchestrivo documentation or ask questions and get answers with citations. - [Flow and run tools](https://docs.orchestrivo.com/mcp-server/tools/flows.md): Find workbooks and saved flows, inspect flow inputs, start runs, and manage run results. - [Help center](https://docs.orchestrivo.com/help/index.md) - [Using Agents](https://docs.orchestrivo.com/help/using-agents/index.md) - [Give an agent a connector](https://docs.orchestrivo.com/help/using-agents/give-agent-access-to-a-connector.md) - [Choose the right AI model](https://docs.orchestrivo.com/help/using-agents/choose-the-right-ai-model.md) - [Does my agent remember conversations?](https://docs.orchestrivo.com/help/using-agents/does-my-agent-remember-conversations.md) - [How do I unsubscribe from OrchestrivoAssistant emails?](https://docs.orchestrivo.com/help/using-agents/unsubscribe-from-orchestrivoassistant-emails.md) - [Browser](https://docs.orchestrivo.com/help/browser/index.md) - [Which should my agent use: connector, API, or browser?](https://docs.orchestrivo.com/help/browser/browser-vs-connector-vs-api.md) - [Why is the browser turned off for me?](https://docs.orchestrivo.com/help/browser/why-is-the-browser-turned-off.md) - [What if a website blocks my agent's browser?](https://docs.orchestrivo.com/help/browser/website-blocks-agent-browser.md) - [Why does the agent keep getting signed out of a website?](https://docs.orchestrivo.com/help/browser/agent-keeps-getting-signed-out.md) - [How do I see what the agent is doing in the browser?](https://docs.orchestrivo.com/help/browser/where-is-the-browser-panel.md) - [Sharing and Teams](https://docs.orchestrivo.com/help/sharing/index.md) - [Roll out an agent](https://docs.orchestrivo.com/help/sharing/roll-out-an-agent.md) - [Create a team](https://docs.orchestrivo.com/help/sharing/create-a-team.md) - [Add someone to your org or team](https://docs.orchestrivo.com/help/sharing/add-someone-to-org-or-team.md) - [Sharing roles](https://docs.orchestrivo.com/help/sharing/sharing-roles.md) - [What can a User see on my agent?](https://docs.orchestrivo.com/help/sharing/what-can-a-user-see.md) - [Who can see tasks on this agent?](https://docs.orchestrivo.com/help/sharing/who-can-see-tasks.md) - [Let someone edit your agent](https://docs.orchestrivo.com/help/sharing/let-someone-edit-an-agent.md) - [Let a User create triggers](https://docs.orchestrivo.com/help/sharing/let-a-user-create-triggers.md) - [Request Owner access](https://docs.orchestrivo.com/help/sharing/request-owner-access.md) - [Claim an ownerless agent](https://docs.orchestrivo.com/help/sharing/claim-an-ownerless-agent.md) - [Keep agents running when someone leaves](https://docs.orchestrivo.com/help/sharing/keep-agents-running-after-someone-leaves.md) - [Credits](https://docs.orchestrivo.com/help/credits/index.md) - [How do I reduce agent credit spend?](https://docs.orchestrivo.com/help/credits/reduce-agent-credit-spend.md) - [Who pays for a shared agent?](https://docs.orchestrivo.com/help/credits/who-gets-charged-shared-agent.md) - [Who pays for an interactive artifact?](https://docs.orchestrivo.com/help/credits/who-pays-interactive-artifact.md) - [Account and Billing](https://docs.orchestrivo.com/help/account-billing/index.md) - [How do I cancel my plan or free trial?](https://docs.orchestrivo.com/help/account-billing/cancel-plan-or-trial.md) - [Where do I download my invoices?](https://docs.orchestrivo.com/help/account-billing/download-an-invoice.md) - [How do I delete my Orchestrivo account?](https://docs.orchestrivo.com/help/account-billing/delete-your-account.md) - [Connectors](https://docs.orchestrivo.com/help/connectors/index.md) - [Add team connectors](https://docs.orchestrivo.com/help/connectors/add-team-connectors.md) - [Use team connectors](https://docs.orchestrivo.com/help/connectors/use-team-connectors.md) - [Connect Gong for your team](https://docs.orchestrivo.com/help/connectors/connect-gong-for-your-team.md): Set up Gong once for your team so everyone can use it in their agents. - [Revoke and reconnect a connector](https://docs.orchestrivo.com/help/connectors/revoke-and-reconnect.md) - [Migrate off a deprecated connector](https://docs.orchestrivo.com/help/connectors/deprecated-connector.md) - [Use your own LLM key](https://docs.orchestrivo.com/help/connectors/use-your-own-llm-key.md) - [Find your Orchestrivo API key](https://docs.orchestrivo.com/help/connectors/find-your-api-key.md): Your personal Orchestrivo API key is in the Orchestrivo API key row on Settings > Profile. Team keys are in each team's settings. - [Brain](https://docs.orchestrivo.com/help/brain/index.md) - [Personal vs team vs organization Brain](https://docs.orchestrivo.com/help/brain/personal-team-org-brain.md) - [Do I need a connector to read Brain?](https://docs.orchestrivo.com/help/brain/do-i-need-a-connector-to-read-brain.md) - [Why can't I see a knowledge source?](https://docs.orchestrivo.com/help/brain/why-cant-i-see-a-knowledge-source.md) - [Why is a document missing from Brain?](https://docs.orchestrivo.com/help/brain/why-is-a-document-missing.md) - [When do permission changes show up?](https://docs.orchestrivo.com/help/brain/when-do-permission-changes-show-up.md) - [How often does Brain sync?](https://docs.orchestrivo.com/help/brain/how-often-does-brain-sync.md) - [Why did my sync fail?](https://docs.orchestrivo.com/help/brain/why-did-my-sync-fail.md) - [How do I sync only certain folders?](https://docs.orchestrivo.com/help/brain/sync-only-certain-folders.md) - [What does pending approval mean?](https://docs.orchestrivo.com/help/brain/what-does-pending-approval-mean.md) - [How do I pause, resume, or delete a source?](https://docs.orchestrivo.com/help/brain/pause-resume-or-delete-a-source.md) - [How do agents use Brain?](https://docs.orchestrivo.com/help/brain/how-do-agents-use-brain.md) - [Skills](https://docs.orchestrivo.com/help/skills/index.md) - [Skills vs subagents](https://docs.orchestrivo.com/help/skills/skills-vs-subagents.md) - [Call integrations from a skill](https://docs.orchestrivo.com/help/skills/skill-script-integrations.md) - [Triggers](https://docs.orchestrivo.com/help/triggers/index.md) - [Stop a scheduled trigger](https://docs.orchestrivo.com/help/triggers/stop-a-scheduled-trigger.md) - [Why did my trigger turn off?](https://docs.orchestrivo.com/help/triggers/why-triggers-turn-off.md) - [Who can manage triggers?](https://docs.orchestrivo.com/help/triggers/who-can-manage-triggers.md) - [MCP](https://docs.orchestrivo.com/help/mcp/index.md) - [Custom, proxied, and hosted MCP](https://docs.orchestrivo.com/help/mcp/custom-proxied-hosted-mcp.md) - [Why won't my custom MCP server connect?](https://docs.orchestrivo.com/help/mcp/custom-mcp-wont-connect.md) - [Orchestrivo MCP connection troubleshooting](https://docs.orchestrivo.com/help/mcp/orchestrivo-mcp-troubleshooting.md) ## OpenAPI Specs - [openapi](/api-reference/openapi.yaml)