# Naïve > Naïve gives every AI agent its own governed real-world agent profile — a verified business identity (EIN/formation), a spend-capped card, an inbox and phone number, and a place to run — provisioned per end-user, governed on every action, and instantly revocable. ## Docs - [Assign user to kit](https://usenaive.ai/docs/api-reference/accountkits/assign-user-to-kit.md) - [Create account kit](https://usenaive.ai/docs/api-reference/accountkits/create-account-kit.md) - [Delete account kit](https://usenaive.ai/docs/api-reference/accountkits/delete-account-kit.md): Delete a non-default account kit with no assigned users. - [Get account kit](https://usenaive.ai/docs/api-reference/accountkits/get-account-kit.md) - [List account kits](https://usenaive.ai/docs/api-reference/accountkits/list-account-kits.md) - [Update account kit](https://usenaive.ai/docs/api-reference/accountkits/update-account-kit.md) - [AI keyword search volume](https://usenaive.ai/docs/api-reference/aeo/ai-keyword-search-volume.md) - [LLM mentions](https://usenaive.ai/docs/api-reference/aeo/llm-mentions.md): Live LLM mentions query. `endpoint`: search, aggregated-metrics, cross-aggregated-metrics, top-domains, top-pages. - [LLM responses (live)](https://usenaive.ai/docs/api-reference/aeo/llm-responses-live.md): Live LLM response query. `platform`: chatgpt, claude, gemini, perplexity. - [LLM responses (models)](https://usenaive.ai/docs/api-reference/aeo/llm-responses-models.md) - [LLM responses (task get)](https://usenaive.ai/docs/api-reference/aeo/llm-responses-task-get.md) - [LLM responses (task post)](https://usenaive.ai/docs/api-reference/aeo/llm-responses-task-post.md): Submit an async LLM response task. `platform`: chatgpt, claude, gemini (perplexity is live-only). - [LLM responses (tasks ready)](https://usenaive.ai/docs/api-reference/aeo/llm-responses-tasks-ready.md) - [LLM scraper (live)](https://usenaive.ai/docs/api-reference/aeo/llm-scraper-live.md) - [LLM scraper (task post)](https://usenaive.ai/docs/api-reference/aeo/llm-scraper-task-post.md) - [Get an agent profile](https://usenaive.ai/docs/api-reference/agentprofiles/get-an-agent-profile.md) - [List agent profiles](https://usenaive.ai/docs/api-reference/agentprofiles/list-agent-profiles.md) - [Provision an agent profile](https://usenaive.ai/docs/api-reference/agentprofiles/provision-an-agent-profile.md): Provision (or idempotently resume) a governed real-world agent profile for the tenant. Pass `default` or `me` as `{user_id}` to target the default agentProfile. - [Revoke an agent profile](https://usenaive.ai/docs/api-reference/agentprofiles/revoke-an-agent-profile.md): Absolute revoke — suspends the agent profile; the governance gateway then denies all further tool calls for it. - [Start a hosted agent (optional)](https://usenaive.ai/docs/api-reference/agentprofiles/start-a-hosted-agent-optional.md): Start an agent for an agent profile on a Naïve-hosted runtime pool. Hosted runtime is enabled per deployment; the lead path is bring-your-own-runtime (pull agentProfile.tools()). - [App data metadata](https://usenaive.ai/docs/api-reference/app-data/app-data-metadata.md): When the second path segment is a metadata type — `locations`, `languages`, or `categories` — returns platform metadata instead of submitting a task. - [App data (task get)](https://usenaive.ai/docs/api-reference/app-data/app-data-task-get.md) - [App data (task post)](https://usenaive.ai/docs/api-reference/app-data/app-data-task-post.md): Submit an app-store data task. `platform`: google or apple. `endpoint`: app-searches, app-list, app-info, app-reviews. - [App data (tasks ready)](https://usenaive.ai/docs/api-reference/app-data/app-data-tasks-ready.md) - [App listings (live)](https://usenaive.ai/docs/api-reference/app-data/app-listings-live.md) - [Approve (company)](https://usenaive.ai/docs/api-reference/approvals/approve-company.md): Approve a pending approval and replay the frozen action. Replay failures are captured on the row (still HTTP 200). - [Approve (user)](https://usenaive.ai/docs/api-reference/approvals/approve-user.md) - [Deny (company)](https://usenaive.ai/docs/api-reference/approvals/deny-company.md) - [Deny (user)](https://usenaive.ai/docs/api-reference/approvals/deny-user.md) - [Get approval (company)](https://usenaive.ai/docs/api-reference/approvals/get-approval-company.md) - [Get approval (user)](https://usenaive.ai/docs/api-reference/approvals/get-approval-user.md) - [List approvals (company)](https://usenaive.ai/docs/api-reference/approvals/list-approvals-company.md): List approvals across all tenant users in the company. - [List approvals (user)](https://usenaive.ai/docs/api-reference/approvals/list-approvals-user.md) - [Add app domain](https://usenaive.ai/docs/api-reference/apps/add-app-domain.md) - [Connect company domain](https://usenaive.ai/docs/api-reference/apps/connect-company-domain.md) - [Create app](https://usenaive.ai/docs/api-reference/apps/create-app.md): Create an app with a Vercel project and an engineer agent. - [Delete app](https://usenaive.ai/docs/api-reference/apps/delete-app.md) - [Delete app secret](https://usenaive.ai/docs/api-reference/apps/delete-app-secret.md) - [Deploy app](https://usenaive.ai/docs/api-reference/apps/deploy-app.md): Deploy by uploading a gzipped tarball (direct mode) or from the container workspace (orchestrated mode). - [Disconnect company domain](https://usenaive.ai/docs/api-reference/apps/disconnect-company-domain.md) - [Get app](https://usenaive.ai/docs/api-reference/apps/get-app.md) - [List app domains](https://usenaive.ai/docs/api-reference/apps/list-app-domains.md) - [List app secrets](https://usenaive.ai/docs/api-reference/apps/list-app-secrets.md) - [List app templates](https://usenaive.ai/docs/api-reference/apps/list-app-templates.md) - [List apps](https://usenaive.ai/docs/api-reference/apps/list-apps.md) - [List database tables](https://usenaive.ai/docs/api-reference/apps/list-database-tables.md) - [List deployments](https://usenaive.ai/docs/api-reference/apps/list-deployments.md) - [Publish deployment](https://usenaive.ai/docs/api-reference/apps/publish-deployment.md): Promote a preview deployment to production. - [Remove app domain](https://usenaive.ai/docs/api-reference/apps/remove-app-domain.md) - [Retry provisioning](https://usenaive.ai/docs/api-reference/apps/retry-provisioning.md) - [Reveal app secret](https://usenaive.ai/docs/api-reference/apps/reveal-app-secret.md) - [Run SQL query](https://usenaive.ai/docs/api-reference/apps/run-sql-query.md): Run arbitrary SQL against the app's Supabase database (fullstack only). - [Set app secret](https://usenaive.ai/docs/api-reference/apps/set-app-secret.md) - [Set primary domain](https://usenaive.ai/docs/api-reference/apps/set-primary-domain.md) - [Supabase Auth proxy](https://usenaive.ai/docs/api-reference/apps/supabase-auth-proxy.md): Data-plane proxy to the Supabase Auth API. Accepts any HTTP method. - [Supabase Functions proxy](https://usenaive.ai/docs/api-reference/apps/supabase-functions-proxy.md): Data-plane proxy to the Supabase Edge Functions API. Accepts any HTTP method. - [Supabase Management proxy](https://usenaive.ai/docs/api-reference/apps/supabase-management-proxy.md): Passthrough proxy to the Supabase Management API scoped to the app's project. Accepts any HTTP method. - [Supabase PostgREST proxy](https://usenaive.ai/docs/api-reference/apps/supabase-postgrest-proxy.md): Passthrough to Supabase PostgREST for the app's project. Accepts any HTTP method. - [Supabase Storage proxy](https://usenaive.ai/docs/api-reference/apps/supabase-storage-proxy.md): Data-plane proxy to the Supabase Storage API. Accepts any HTTP method. - [Vercel API proxy](https://usenaive.ai/docs/api-reference/apps/vercel-api-proxy.md): Passthrough proxy to the Vercel API scoped to the app's project. Accepts any HTTP method; Naive injects credentials. - [Verify domain DNS](https://usenaive.ai/docs/api-reference/apps/verify-domain-dns.md) - [Change password](https://usenaive.ai/docs/api-reference/auth-&-onboarding/change-password.md): Change the password for the session user's credential account. - [Create API key](https://usenaive.ai/docs/api-reference/auth-&-onboarding/create-api-key.md): Create a new API key for the authenticated agent, optionally scoped to an account kit and tenant user. - [Create company (session)](https://usenaive.ai/docs/api-reference/auth-&-onboarding/create-company-session.md): Create a new company for the session user, optionally applying a business template. - [Current agent](https://usenaive.ai/docs/api-reference/auth-&-onboarding/current-agent.md): Return the authenticated agent and company context. - [Exchange OAuth code for session](https://usenaive.ai/docs/api-reference/auth-&-onboarding/exchange-oauth-code-for-session.md): Exchange a one-time OAuth code for a session cookie and user/company context. - [Get session](https://usenaive.ai/docs/api-reference/auth-&-onboarding/get-session.md): Get the current session user/company context from the cookie. - [Google OAuth callback](https://usenaive.ai/docs/api-reference/auth-&-onboarding/google-oauth-callback.md): Handle the Google OAuth callback and redirect to the app with a one-time exchange code. - [List accessible companies](https://usenaive.ai/docs/api-reference/auth-&-onboarding/list-accessible-companies.md): List companies accessible to the authenticated agent. - [List API keys](https://usenaive.ai/docs/api-reference/auth-&-onboarding/list-api-keys.md): List API keys for the current company (key values are never returned). - [Login](https://usenaive.ai/docs/api-reference/auth-&-onboarding/login.md): Authenticate with email/password and receive an API key for the first active company. - [Logout](https://usenaive.ai/docs/api-reference/auth-&-onboarding/logout.md): Delete the session and clear the session cookie. - [Register](https://usenaive.ai/docs/api-reference/auth-&-onboarding/register.md): Create a new user, company, agent, trial credits, and a default API key. - [Resend verification email](https://usenaive.ai/docs/api-reference/auth-&-onboarding/resend-verification-email.md): Resend the verification email link to the session user. - [Revoke API key](https://usenaive.ai/docs/api-reference/auth-&-onboarding/revoke-api-key.md): Revoke an API key owned by the authenticated agent. - [Send email link code](https://usenaive.ai/docs/api-reference/auth-&-onboarding/send-email-link-code.md): Start an email-link flow by sending a 6-digit verification code. - [Session login](https://usenaive.ai/docs/api-reference/auth-&-onboarding/session-login.md): Session-based login for the Studio UI; sets the `naive_session` cookie. - [Session register](https://usenaive.ai/docs/api-reference/auth-&-onboarding/session-register.md): Session-based registration; provisions a company, default kit/user, CEO agent, and sends a verification email. - [Start Google OAuth](https://usenaive.ai/docs/api-reference/auth-&-onboarding/start-google-oauth.md): Redirect to the Google OAuth consent screen (browser flow). - [Switch active company (session)](https://usenaive.ai/docs/api-reference/auth-&-onboarding/switch-active-company-session.md): Switch the active company in the current session. - [Switch company context](https://usenaive.ai/docs/api-reference/auth-&-onboarding/switch-company-context.md): Switch the API key context to a different company, issuing a new agent + key. - [Verify email link code](https://usenaive.ai/docs/api-reference/auth-&-onboarding/verify-email-link-code.md): Verify a 6-digit email-link code and receive an API key. - [Verify email token](https://usenaive.ai/docs/api-reference/auth-&-onboarding/verify-email-token.md): Verify an email using the token from the verification email link. - [Billing portal](https://usenaive.ai/docs/api-reference/billing/billing-portal.md) - [Billing status](https://usenaive.ai/docs/api-reference/billing/billing-status.md) - [Get subscription](https://usenaive.ai/docs/api-reference/billing/get-subscription.md) - [List credit packs](https://usenaive.ai/docs/api-reference/billing/list-credit-packs.md) - [List plans](https://usenaive.ai/docs/api-reference/billing/list-plans.md) - [List transactions](https://usenaive.ai/docs/api-reference/billing/list-transactions.md) - [Subscribe](https://usenaive.ai/docs/api-reference/billing/subscribe.md): Create a subscription checkout session - [Top up credits](https://usenaive.ai/docs/api-reference/billing/top-up-credits.md) - [Upgrade Plan](https://usenaive.ai/docs/api-reference/billing/upgrade.md): Upgrade to a higher subscription plan - [Act](https://usenaive.ai/docs/api-reference/browser/act.md): Perform a write action via natural-language instruction. Requires an `Idempotency-Key` header. - [Autonomous login](https://usenaive.ai/docs/api-reference/browser/autonomous-login.md): Autonomous login using a vault-stored credential. Requires an agent API key. - [Autonomous signup](https://usenaive.ai/docs/api-reference/browser/autonomous-signup.md): Autonomous self-contained signup. Approval-gated for non-default agents. - [Close browser session](https://usenaive.ai/docs/api-reference/browser/close-browser-session.md) - [Extract data](https://usenaive.ai/docs/api-reference/browser/extract-data.md) - [Get browser session](https://usenaive.ai/docs/api-reference/browser/get-browser-session.md) - [Grant context access](https://usenaive.ai/docs/api-reference/browser/grant-context-access.md) - [List browser sessions](https://usenaive.ai/docs/api-reference/browser/list-browser-sessions.md) - [Live-view URL](https://usenaive.ai/docs/api-reference/browser/live-view-url.md) - [Navigate](https://usenaive.ai/docs/api-reference/browser/navigate.md): Navigate the session to a URL. Requires an `Idempotency-Key` header. - [Observe actions](https://usenaive.ai/docs/api-reference/browser/observe-actions.md) - [Open browser session](https://usenaive.ai/docs/api-reference/browser/open-browser-session.md): Open a live browser session (0 credits at create). Requires an agent API key. - [Revoke login context](https://usenaive.ai/docs/api-reference/browser/revoke-login-context.md) - [Save login context](https://usenaive.ai/docs/api-reference/browser/save-login-context.md) - [Screenshot](https://usenaive.ai/docs/api-reference/browser/screenshot.md) - [Store login credential](https://usenaive.ai/docs/api-reference/browser/store-login-credential.md) - [Business data (task get)](https://usenaive.ai/docs/api-reference/business-data/business-data-task-get.md) - [Business data (task post)](https://usenaive.ai/docs/api-reference/business-data/business-data-task-post.md): Submit a business-data task. `platform`: google, trustpilot, tripadvisor. `endpoint` varies per platform (e.g. reviews, search, my-business-updates). - [Business data (tasks ready)](https://usenaive.ai/docs/api-reference/business-data/business-data-tasks-ready.md) - [Google business (live)](https://usenaive.ai/docs/api-reference/business-data/google-business-live.md): Live Google business-data query. `endpoint`: my-business-info, hotel-searches, hotel-info, questions-and-answers. - [Social business data (live)](https://usenaive.ai/docs/api-reference/business-data/social-business-data-live.md): Live social media business-data query. `platform`: facebook, pinterest, reddit. - [Assign card to agent](https://usenaive.ai/docs/api-reference/cards/assign-card-to-agent.md) - [Cancel card](https://usenaive.ai/docs/api-reference/cards/cancel-card.md) - [Card details](https://usenaive.ai/docs/api-reference/cards/card-details.md): Sensitive card credentials (active cards only). - [Check Payment](https://usenaive.ai/docs/api-reference/cards/check-payment.md): Check the checkout payment status for a card - [Create card](https://usenaive.ai/docs/api-reference/cards/create-card.md): Create a virtual card and a Stripe checkout for funding. Approval-gated. - [Create Cardholder](https://usenaive.ai/docs/api-reference/cards/create-cardholder.md): Create a virtual card cardholder for the company - [Get cardholder](https://usenaive.ai/docs/api-reference/cards/get-cardholder.md) - [List card assignments](https://usenaive.ai/docs/api-reference/cards/list-card-assignments.md) - [List cards](https://usenaive.ai/docs/api-reference/cards/list-cards.md) - [List transactions](https://usenaive.ai/docs/api-reference/cards/list-transactions.md) - [Log Transaction](https://usenaive.ai/docs/api-reference/cards/log-transaction.md): Manually log a transaction against a card - [Refund card payment](https://usenaive.ai/docs/api-reference/cards/refund-card-payment.md) - [Retry issuance](https://usenaive.ai/docs/api-reference/cards/retry-issuance.md) - [Top up card](https://usenaive.ai/docs/api-reference/cards/top-up-card.md) - [Unassign card](https://usenaive.ai/docs/api-reference/cards/unassign-card.md) - [Update Cardholder](https://usenaive.ai/docs/api-reference/cards/update-cardholder.md): Update the company's virtual card cardholder - [Create clips from YouTube](https://usenaive.ai/docs/api-reference/clips/create-clips-from-youtube.md): Submit a YouTube URL to Submagic for AI clip extraction (async job). - [Edit video](https://usenaive.ai/docs/api-reference/clips/edit-video.md): Submit a public MP4/MOV URL to Submagic for AI video editing (async job). - [Get clip job](https://usenaive.ai/docs/api-reference/clips/get-clip-job.md) - [Create compute resource](https://usenaive.ai/docs/api-reference/compute/create-compute-resource.md): Create an ECS/Fargate service, job, or schedule. Approval-gated for non-default agent callers. - [Delete compute resource](https://usenaive.ai/docs/api-reference/compute/delete-compute-resource.md) - [Delete compute secret](https://usenaive.ai/docs/api-reference/compute/delete-compute-secret.md) - [Exec command](https://usenaive.ai/docs/api-reference/compute/exec-command.md): One-shot ECS Exec session. Approval-gated for non-default agent callers. - [Get compute resource](https://usenaive.ai/docs/api-reference/compute/get-compute-resource.md) - [Interactive shell](https://usenaive.ai/docs/api-reference/compute/interactive-shell.md) - [List compute resources](https://usenaive.ai/docs/api-reference/compute/list-compute-resources.md) - [List compute secrets](https://usenaive.ai/docs/api-reference/compute/list-compute-secrets.md) - [List runs](https://usenaive.ai/docs/api-reference/compute/list-runs.md) - [Resource logs](https://usenaive.ai/docs/api-reference/compute/resource-logs.md) - [Reveal compute secret](https://usenaive.ai/docs/api-reference/compute/reveal-compute-secret.md) - [Run job](https://usenaive.ai/docs/api-reference/compute/run-job.md) - [Run logs](https://usenaive.ai/docs/api-reference/compute/run-logs.md) - [Scale service](https://usenaive.ai/docs/api-reference/compute/scale-service.md) - [Set compute secret](https://usenaive.ai/docs/api-reference/compute/set-compute-secret.md) - [Start service](https://usenaive.ai/docs/api-reference/compute/start-service.md) - [Stop service](https://usenaive.ai/docs/api-reference/compute/stop-service.md) - [Connect a toolkit](https://usenaive.ai/docs/api-reference/connections/connect-a-toolkit.md): Start a Composio OAuth/API-key connect flow. Agent callers may be deferred to the approvals queue. - [Disconnect a toolkit](https://usenaive.ai/docs/api-reference/connections/disconnect-a-toolkit.md): Soft-disable by default, or permanently delete/revoke with `purge`. - [Execute a tool](https://usenaive.ai/docs/api-reference/connections/execute-a-tool.md): Execute a Composio tool for the user, gated by the AccountKit policy. Returns HTTP 200 even when the tool reports `successful: false`. - [List all toolkits](https://usenaive.ai/docs/api-reference/connections/list-all-toolkits.md): Company-level unfiltered Composio toolkit catalog for the AccountKit editor. - [List connected accounts](https://usenaive.ai/docs/api-reference/connections/list-connected-accounts.md): List locally mirrored connected accounts (cheap DB read). - [List toolkit catalog](https://usenaive.ai/docs/api-reference/connections/list-toolkit-catalog.md): List the Composio toolkit catalog with connection status, filtered by the user's AccountKit policy. - [List toolkit tools](https://usenaive.ai/docs/api-reference/connections/list-toolkit-tools.md): List tools exposed by a toolkit with Composio input schemas. - [Activity feed](https://usenaive.ai/docs/api-reference/dashboard/activity-feed.md) - [Dashboard overview](https://usenaive.ai/docs/api-reference/dashboard/dashboard-overview.md) - [Subscribe (session)](https://usenaive.ai/docs/api-reference/dashboard/subscribe-session.md) - [Transactions](https://usenaive.ai/docs/api-reference/dashboard/transactions.md) - [Usage summary](https://usenaive.ai/docs/api-reference/dashboard/usage-summary.md) - [Connect domain (BYOD)](https://usenaive.ai/docs/api-reference/domains/connect-domain-byod.md): Connect a custom domain; returns DNS records to add at the registrar. - [Create/replace zone record](https://usenaive.ai/docs/api-reference/domains/createreplace-zone-record.md) - [Delete zone record](https://usenaive.ai/docs/api-reference/domains/delete-zone-record.md) - [Get DNS setup records](https://usenaive.ai/docs/api-reference/domains/get-dns-setup-records.md) - [List domains](https://usenaive.ai/docs/api-reference/domains/list-domains.md) - [List zone records](https://usenaive.ai/docs/api-reference/domains/list-zone-records.md): List live DNS records in the Vercel-managed zone (agent DNS edit). - [Purchase domain](https://usenaive.ai/docs/api-reference/domains/purchase-domain.md): Initiate a domain purchase via Stripe checkout. Approval-gated for agent callers. - [Search domain availability](https://usenaive.ai/docs/api-reference/domains/search-domain-availability.md) - [Verify domain](https://usenaive.ai/docs/api-reference/domains/verify-domain.md) - [E-commerce metadata](https://usenaive.ai/docs/api-reference/e-commerce/e-commerce-metadata.md): Platform metadata. `meta`: locations, languages. - [E-commerce (task get)](https://usenaive.ai/docs/api-reference/e-commerce/e-commerce-task-get.md) - [E-commerce (task post)](https://usenaive.ai/docs/api-reference/e-commerce/e-commerce-task-post.md): Submit a merchant data task. `platform`: google (products, product-info, sellers, reviews) or amazon (products, asin, sellers). - [E-commerce (tasks ready)](https://usenaive.ai/docs/api-reference/e-commerce/e-commerce-tasks-ready.md) - [Create Inbox](https://usenaive.ai/docs/api-reference/email/create-inbox.md): POST /v1/email/inboxes — Create a new email inbox on your company's domain. - [Delete Inbox](https://usenaive.ai/docs/api-reference/email/delete-inbox.md): DELETE /v1/email/inboxes/:id — Deactivate an email inbox (soft delete). - [Get inbound email](https://usenaive.ai/docs/api-reference/email/get-inbound-email.md) - [List inbound emails](https://usenaive.ai/docs/api-reference/email/list-inbound-emails.md) - [List inboxes](https://usenaive.ai/docs/api-reference/email/list-inboxes.md) - [Send email](https://usenaive.ai/docs/api-reference/email/send-email.md): Send an outbound email from an owned inbox. Costs 10 credits and is metered against the plan quota. - [Event stream (SSE)](https://usenaive.ai/docs/api-reference/events/event-stream-sse.md): Server-Sent Events stream of company-scoped live events (DNS edits, activity log, approvals). Heartbeat every ~25s. - [Download file](https://usenaive.ai/docs/api-reference/files/download-file.md): Download raw file bytes from the container workspace. - [View file](https://usenaive.ai/docs/api-reference/files/view-file.md): Read text file contents from the container workspace (max 1MB). - [Create formation](https://usenaive.ai/docs/api-reference/formation/create-formation.md): Create an LLC formation and a $249 Stripe checkout. Approval-gated. - [Get document](https://usenaive.ai/docs/api-reference/formation/get-document.md) - [Get formation](https://usenaive.ai/docs/api-reference/formation/get-formation.md) - [List documents](https://usenaive.ai/docs/api-reference/formation/list-documents.md) - [List formations](https://usenaive.ai/docs/api-reference/formation/list-formations.md) - [List NAICS codes](https://usenaive.ai/docs/api-reference/formation/list-naics-codes.md) - [Retry Formation Payment](https://usenaive.ai/docs/api-reference/formation/retry-payment.md): POST /v1/formation/:id/retry-payment — Generate a fresh hosted checkout URL for a formation whose checkout session expired. - [Submit formation](https://usenaive.ai/docs/api-reference/formation/submit-formation.md): Submit a paid formation to Doola. Approval-gated. - [Get identity](https://usenaive.ai/docs/api-reference/identity/get-identity.md): Get the authenticated agent identity, company, resources (emails/domains), and credit balance. - [List emails](https://usenaive.ai/docs/api-reference/identity/list-emails.md): List active email addresses for the authenticated company. - [List resources](https://usenaive.ai/docs/api-reference/identity/list-resources.md): List active emails and all domains for the authenticated company. - [Generate image](https://usenaive.ai/docs/api-reference/images/generate-image.md): Queue an async fal.ai image generation job. Credits are charged on completion only. - [Get image job](https://usenaive.ai/docs/api-reference/images/get-image-job.md) - [Image pricing](https://usenaive.ai/docs/api-reference/images/image-pricing.md) - [List image models](https://usenaive.ai/docs/api-reference/images/list-image-models.md) - [Search stock photos](https://usenaive.ai/docs/api-reference/images/search-stock-photos.md) - [Cancel job](https://usenaive.ai/docs/api-reference/jobs/cancel-job.md) - [Get job](https://usenaive.ai/docs/api-reference/jobs/get-job.md) - [List jobs](https://usenaive.ai/docs/api-reference/jobs/list-jobs.md) - [Chat completions](https://usenaive.ai/docs/api-reference/llm/chat-completions.md): OpenAI/OpenRouter-compatible chat completions. Set `stream: true` for an SSE response. Naive billing fields (`credits_used`) are appended to non-streaming responses. - [Get generation stats](https://usenaive.ai/docs/api-reference/llm/get-generation-stats.md) - [List models](https://usenaive.ai/docs/api-reference/llm/list-models.md) - [Query logs (company)](https://usenaive.ai/docs/api-reference/logs/query-logs-company.md): Cross-user activity log query for the agent profile dashboard. - [Query logs (user)](https://usenaive.ai/docs/api-reference/logs/query-logs-user.md): Query per-user activity audit events, newest first. - [Stream logs (SSE)](https://usenaive.ai/docs/api-reference/logs/stream-logs-sse.md): Server-Sent Events live tail of `activity.logged` events for this user. - [Delete media asset](https://usenaive.ai/docs/api-reference/media/delete-media-asset.md) - [Get media asset](https://usenaive.ai/docs/api-reference/media/get-media-asset.md) - [Import media from URL](https://usenaive.ai/docs/api-reference/media/import-media-from-url.md) - [List media assets](https://usenaive.ai/docs/api-reference/media/list-media-assets.md) - [Update media asset](https://usenaive.ai/docs/api-reference/media/update-media-asset.md) - [Upload media file](https://usenaive.ai/docs/api-reference/media/upload-media-file.md) - [Attach proxy](https://usenaive.ai/docs/api-reference/mobile/attach-proxy.md): Attach a SOCKS5 proxy for a residential / country-specific IP. SENSITIVE — may require approval. - [Create signed app upload URL](https://usenaive.ai/docs/api-reference/mobile/create-signed-app-upload-url.md) - [Get device](https://usenaive.ai/docs/api-reference/mobile/get-device.md) - [Get device proxy](https://usenaive.ai/docs/api-reference/mobile/get-device-proxy.md): Current proxy attachment (devices default to a datacenter IP). - [Get live stream](https://usenaive.ai/docs/api-reference/mobile/get-live-stream.md): Live-stream details for the device screen. Requires an active phone. `stream_url` is a WebRTC signaling socket (wss) + short-lived `stream_token` — render it with a WebRTC client, or send a human to `console_url` (the Mobilerun dashboard) to watch and control the device. - [Get task](https://usenaive.ai/docs/api-reference/mobile/get-task.md) - [Get task trajectory](https://usenaive.ai/docs/api-reference/mobile/get-task-trajectory.md) - [List apps](https://usenaive.ai/docs/api-reference/mobile/list-apps.md) - [List devices](https://usenaive.ai/docs/api-reference/mobile/list-devices.md): List the phones/devices you provisioned, enriched with live state. - [List task screenshots](https://usenaive.ai/docs/api-reference/mobile/list-task-screenshots.md) - [List tasks](https://usenaive.ai/docs/api-reference/mobile/list-tasks.md) - [Mobile status](https://usenaive.ai/docs/api-reference/mobile/mobile-status.md): Whether Mobile is configured + reachable, plus your active/pending phone counts and per-phone price. - [Provision a phone](https://usenaive.ai/docs/api-reference/mobile/provision-a-phone.md): Create a cloud phone. Provisions immediately and meters your credits per device-minute until terminated — there is no upstream auto-stop; running out of credits auto-terminates the phone. SENSITIVE — may require approval. - [Remove proxy](https://usenaive.ai/docs/api-reference/mobile/remove-proxy.md): Detach the proxy (back to the datacenter IP). SENSITIVE — may require approval. - [Run agent task](https://usenaive.ai/docs/api-reference/mobile/run-agent-task.md): Run a natural-language task on one of your devices, with optional vision + reasoning. SENSITIVE — may require approval. - [Search Mobilerun operations](https://usenaive.ai/docs/api-reference/mobile/search-mobilerun-operations.md): Search the generated catalog of every Mobilerun operation (for the wildcard call). Optionally filter by keyword (`q`) and tag. - [Stop task](https://usenaive.ai/docs/api-reference/mobile/stop-task.md) - [Terminate device](https://usenaive.ai/docs/api-reference/mobile/terminate-device.md): Release the device — this is what stops the per-minute meter. SENSITIVE. - [Wait for device ready](https://usenaive.ai/docs/api-reference/mobile/wait-for-device-ready.md) - [Wildcard call](https://usenaive.ai/docs/api-reference/mobile/wildcard-call.md): Execute any Mobilerun operation by catalog operationId. Device-/task-scoped operations are guarded to your own resources. SENSITIVE when mutating. - [Abandon objective](https://usenaive.ai/docs/api-reference/orchestration/abandon-objective.md) - [Active CEO run](https://usenaive.ai/docs/api-reference/orchestration/active-ceo-run.md): Return the in-flight CEO run so a client can re-attach after reload. - [Add memory](https://usenaive.ai/docs/api-reference/orchestration/add-memory.md): Request a memory write via the CEO run (the CEO incorporates it into MEMORY.md). - [Approve CEO team plan](https://usenaive.ai/docs/api-reference/orchestration/approve-ceo-team-plan.md): Approve a CEO-proposed team plan — creates agents, provisions them, and optionally creates apps and phase-1 tasks. - [Archive objective](https://usenaive.ai/docs/api-reference/orchestration/archive-objective.md) - [Block task](https://usenaive.ai/docs/api-reference/orchestration/block-task.md) - [CEO login briefing](https://usenaive.ai/docs/api-reference/orchestration/ceo-login-briefing.md): Activity since last login for a CEO briefing summary. - [CEO Status](https://usenaive.ai/docs/api-reference/orchestration/ceo-status.md): GET /v1/companies/:companyId/ceo/status — Get the CEO agent's current runtime state. - [Comment on task](https://usenaive.ai/docs/api-reference/orchestration/comment-on-task.md) - [Complete task](https://usenaive.ai/docs/api-reference/orchestration/complete-task.md) - [Create cron job](https://usenaive.ai/docs/api-reference/orchestration/create-cron-job.md) - [Create objective](https://usenaive.ai/docs/api-reference/orchestration/create-objective.md) - [Create task](https://usenaive.ai/docs/api-reference/orchestration/create-task.md) - [Delete cron job](https://usenaive.ai/docs/api-reference/orchestration/delete-cron-job.md) - [Delete memory](https://usenaive.ai/docs/api-reference/orchestration/delete-memory.md) - [Delete task](https://usenaive.ai/docs/api-reference/orchestration/delete-task.md) - [Dispatch tasks](https://usenaive.ai/docs/api-reference/orchestration/dispatch-tasks.md): Push-through to the sidecar kanban dispatcher. - [Fire employee](https://usenaive.ai/docs/api-reference/orchestration/fire-employee.md): Archive employee (soft delete) and deprovision from the container. - [Get CEO run](https://usenaive.ai/docs/api-reference/orchestration/get-ceo-run.md) - [Get employee](https://usenaive.ai/docs/api-reference/orchestration/get-employee.md) - [Get objective](https://usenaive.ai/docs/api-reference/orchestration/get-objective.md) - [Get task](https://usenaive.ai/docs/api-reference/orchestration/get-task.md): Get task detail with runs, events, and comments. - [Hire employee](https://usenaive.ai/docs/api-reference/orchestration/hire-employee.md) - [List agent messages](https://usenaive.ai/docs/api-reference/orchestration/list-agent-messages.md) - [List CEO messages](https://usenaive.ai/docs/api-reference/orchestration/list-ceo-messages.md) - [List CEO sessions](https://usenaive.ai/docs/api-reference/orchestration/list-ceo-sessions.md) - [List cron executions](https://usenaive.ai/docs/api-reference/orchestration/list-cron-executions.md) - [List cron jobs](https://usenaive.ai/docs/api-reference/orchestration/list-cron-jobs.md) - [List employees](https://usenaive.ai/docs/api-reference/orchestration/list-employees.md) - [List memory](https://usenaive.ai/docs/api-reference/orchestration/list-memory.md) - [List objectives](https://usenaive.ai/docs/api-reference/orchestration/list-objectives.md) - [List tasks](https://usenaive.ai/docs/api-reference/orchestration/list-tasks.md) - [Pause cron job](https://usenaive.ai/docs/api-reference/orchestration/pause-cron-job.md) - [Pause objective](https://usenaive.ai/docs/api-reference/orchestration/pause-objective.md) - [Persist agent message](https://usenaive.ai/docs/api-reference/orchestration/persist-agent-message.md) - [Persist CEO message](https://usenaive.ai/docs/api-reference/orchestration/persist-ceo-message.md) - [Read CEO workspace file](https://usenaive.ai/docs/api-reference/orchestration/read-ceo-workspace-file.md) - [Remove memory by text](https://usenaive.ai/docs/api-reference/orchestration/remove-memory-by-text.md) - [Run agent](https://usenaive.ai/docs/api-reference/orchestration/run-agent.md): Trigger a run for a specific non-CEO agent. - [Run task](https://usenaive.ai/docs/api-reference/orchestration/run-task.md) - [Send CEO message](https://usenaive.ai/docs/api-reference/orchestration/send-ceo-message.md): Inject text into the active CEO run. - [Start CEO run](https://usenaive.ai/docs/api-reference/orchestration/start-ceo-run.md): Trigger a Hermes CEO run. Also available at `/v1/companies/{id}/ceo/run` and `/v1/users/{user_id}/ceo/run`. - [Stop agent run](https://usenaive.ai/docs/api-reference/orchestration/stop-agent-run.md) - [Stop CEO run](https://usenaive.ai/docs/api-reference/orchestration/stop-ceo-run.md) - [Stream agent run (SSE)](https://usenaive.ai/docs/api-reference/orchestration/stream-agent-run-sse.md) - [Stream CEO run (SSE)](https://usenaive.ai/docs/api-reference/orchestration/stream-ceo-run-sse.md): Server-Sent Events proxy of the CEO run output. - [Task stats](https://usenaive.ai/docs/api-reference/orchestration/task-stats.md) - [Trigger cron job](https://usenaive.ai/docs/api-reference/orchestration/trigger-cron-job.md) - [Unblock task](https://usenaive.ai/docs/api-reference/orchestration/unblock-task.md) - [Update cron job](https://usenaive.ai/docs/api-reference/orchestration/update-cron-job.md) - [Update employee](https://usenaive.ai/docs/api-reference/orchestration/update-employee.md) - [Update objective](https://usenaive.ai/docs/api-reference/orchestration/update-objective.md) - [Update task](https://usenaive.ai/docs/api-reference/orchestration/update-task.md) - [Warm CEO gateway](https://usenaive.ai/docs/api-reference/orchestration/warm-ceo-gateway.md): Poll the sidecar until the Hermes gateway is ready (pre-warm before sending). - [API Overview](https://usenaive.ai/docs/api-reference/overview.md): Base URL, authentication, and endpoint conventions for the Naive API v2. - [Assign agent to phone](https://usenaive.ai/docs/api-reference/phone/assign-agent-to-phone.md) - [Get campaign](https://usenaive.ai/docs/api-reference/phone/get-campaign.md) - [Get inbound SMS](https://usenaive.ai/docs/api-reference/phone/get-inbound-sms.md) - [Get phone number](https://usenaive.ai/docs/api-reference/phone/get-phone-number.md) - [List inbound SMS](https://usenaive.ai/docs/api-reference/phone/list-inbound-sms.md) - [List phone assignments](https://usenaive.ai/docs/api-reference/phone/list-phone-assignments.md) - [List phone numbers](https://usenaive.ai/docs/api-reference/phone/list-phone-numbers.md) - [Phone account status](https://usenaive.ai/docs/api-reference/phone/phone-account-status.md) - [Provision phone number](https://usenaive.ai/docs/api-reference/phone/provision-phone-number.md): Buy a US phone number and register a 10DLC campaign. Approval-gated for non-default agent callers. - [Release phone number](https://usenaive.ai/docs/api-reference/phone/release-phone-number.md) - [Send SMS](https://usenaive.ai/docs/api-reference/phone/send-sms.md): Send an outbound SMS. Metered; gated until the 10DLC campaign is approved. - [Unassign agent from phone](https://usenaive.ai/docs/api-reference/phone/unassign-agent-from-phone.md) - [Create/upsert plan definition](https://usenaive.ai/docs/api-reference/plans/createupsert-plan-definition.md) - [List plan definitions](https://usenaive.ai/docs/api-reference/plans/list-plan-definitions.md) - [Get playground session](https://usenaive.ai/docs/api-reference/playground/get-playground-session.md) - [Reset playground](https://usenaive.ai/docs/api-reference/playground/reset-playground.md) - [Start playground run](https://usenaive.ai/docs/api-reference/playground/start-playground-run.md) - [Stream playground run (SSE)](https://usenaive.ai/docs/api-reference/playground/stream-playground-run-sse.md) - [Acknowledge message](https://usenaive.ai/docs/api-reference/queue/acknowledge-message.md) - [Create queue](https://usenaive.ai/docs/api-reference/queue/create-queue.md) - [Delete queue](https://usenaive.ai/docs/api-reference/queue/delete-queue.md) - [Get queue](https://usenaive.ai/docs/api-reference/queue/get-queue.md) - [List queues](https://usenaive.ai/docs/api-reference/queue/list-queues.md) - [Purge queue](https://usenaive.ai/docs/api-reference/queue/purge-queue.md) - [Queue attributes](https://usenaive.ai/docs/api-reference/queue/queue-attributes.md) - [Receive messages](https://usenaive.ai/docs/api-reference/queue/receive-messages.md) - [Send message](https://usenaive.ai/docs/api-reference/queue/send-message.md) - [Read URL](https://usenaive.ai/docs/api-reference/search/read-url.md): POST /v1/search/url — Fetch and extract content from a URL. - [Deep Research](https://usenaive.ai/docs/api-reference/search/research.md): POST /v1/search/research — Multi-source research with AI synthesis. - [Web Search](https://usenaive.ai/docs/api-reference/search/web-search.md): POST /v1/search — Search the web for information. - [Backlinks (live)](https://usenaive.ai/docs/api-reference/seo/backlinks-live.md): Live DataForSEO Backlinks query. `endpoint` is one of: summary, history, backlinks, anchors, domain-pages, domain-pages-summary, referring-domains, referring-networks, competitors, domain-intersection, page-intersection, timeseries-summary, timeseries-new-lost, bulk-backlinks, bulk-referring-domains… - [Backlinks metadata](https://usenaive.ai/docs/api-reference/seo/backlinks-metadata.md): When `endpoint` is `index` or `available-filters`, returns Backlinks API metadata instead of running a query. - [Keywords (live)](https://usenaive.ai/docs/api-reference/seo/keywords-live.md): Live DataForSEO Keywords Data query. Each engine/endpoint pair is a concrete route; the table below lists the supported values. - [Keywords metadata](https://usenaive.ai/docs/api-reference/seo/keywords-metadata.md): When the second path segment is a metadata type — `locations`, `languages`, `categories`, or `adwords-status` (Google only) — returns Keywords Data metadata for the engine instead of running a query. - [Keywords (task get)](https://usenaive.ai/docs/api-reference/seo/keywords-task-get.md) - [Keywords (task post)](https://usenaive.ai/docs/api-reference/seo/keywords-task-post.md) - [Keywords (tasks ready)](https://usenaive.ai/docs/api-reference/seo/keywords-tasks-ready.md) - [Labs (live)](https://usenaive.ai/docs/api-reference/seo/labs-live.md): Live DataForSEO Labs query. `engine` is one of: google, bing, amazon. See https://docs.dataforseo.com for the per-engine endpoint list (e.g. ranked-keywords, keyword-ideas, competitors-domain, bulk-keyword-difficulty). - [Labs metadata](https://usenaive.ai/docs/api-reference/seo/labs-metadata.md): Labs metadata. `meta` is one of: locations-and-languages, categories, status. - [Create MCP session](https://usenaive.ai/docs/api-reference/sessions/create-mcp-session.md): Create a TTL'd, revocable MCP session. The bearer token is returned once. - [List MCP sessions](https://usenaive.ai/docs/api-reference/sessions/list-mcp-sessions.md): List MCP sessions for a tenant user (tokens are never returned). - [Revoke MCP session](https://usenaive.ai/docs/api-reference/sessions/revoke-mcp-session.md) - [Session tools](https://usenaive.ai/docs/api-reference/sessions/session-tools.md): Return MCP connect info for an active session. - [Account Analytics](https://usenaive.ai/docs/api-reference/social/account-analytics.md): GET /v1/social/accounts/:id/analytics — Get analytics for a connected social account. - [Activate social](https://usenaive.ai/docs/api-reference/social/activate-social.md) - [Connect platform](https://usenaive.ai/docs/api-reference/social/connect-platform.md) - [Create Post](https://usenaive.ai/docs/api-reference/social/create-post.md): POST /v1/social/posts — Create a social post as a draft, or publish/schedule it immediately. - [Delete Post](https://usenaive.ai/docs/api-reference/social/delete-post.md): DELETE /v1/social/posts/:id — Delete a social post. - [Disconnect account](https://usenaive.ai/docs/api-reference/social/disconnect-account.md) - [Edit Post](https://usenaive.ai/docs/api-reference/social/edit-post.md): PATCH /v1/social/posts/:id — Update a draft social post. - [Get Post](https://usenaive.ai/docs/api-reference/social/get-post.md): GET /v1/social/posts/:id — Retrieve a single social post by ID. - [Label account](https://usenaive.ai/docs/api-reference/social/label-account.md) - [List Posts](https://usenaive.ai/docs/api-reference/social/list-posts.md): GET /v1/social/posts — List social posts with optional filtering and pagination. - [List social accounts](https://usenaive.ai/docs/api-reference/social/list-social-accounts.md) - [List uploads](https://usenaive.ai/docs/api-reference/social/list-uploads.md) - [Multi-platform portal](https://usenaive.ai/docs/api-reference/social/multi-platform-portal.md) - [Post Analytics](https://usenaive.ai/docs/api-reference/social/post-analytics.md): GET /v1/social/posts/:id/analytics — Get analytics for a published post. - [Post Comments](https://usenaive.ai/docs/api-reference/social/post-comments.md): GET /v1/social/posts/:id/comments — Get comments on a published post. - [Publish Post](https://usenaive.ai/docs/api-reference/social/publish-post.md): POST /v1/social/posts/:id/publish — Publish a draft social post. - [Social status](https://usenaive.ai/docs/api-reference/social/social-status.md) - [Sync accounts](https://usenaive.ai/docs/api-reference/social/sync-accounts.md) - [Upload media file](https://usenaive.ai/docs/api-reference/social/upload-media-file.md) - [Upload media from URL](https://usenaive.ai/docs/api-reference/social/upload-media-from-url.md) - [Account status](https://usenaive.ai/docs/api-reference/status/account-status.md) - [Health check](https://usenaive.ai/docs/api-reference/status/health-check.md): Liveness probe. No authentication required. - [Usage summary](https://usenaive.ai/docs/api-reference/status/usage-summary.md) - [Get template app](https://usenaive.ai/docs/api-reference/template-apps/get-template-app.md) - [Install template app](https://usenaive.ai/docs/api-reference/template-apps/install-template-app.md) - [List template apps](https://usenaive.ai/docs/api-reference/template-apps/list-template-apps.md) - [Remove template app](https://usenaive.ai/docs/api-reference/template-apps/remove-template-app.md) - [Apply template](https://usenaive.ai/docs/api-reference/templates/apply-template.md) - [Get template](https://usenaive.ai/docs/api-reference/templates/get-template.md) - [List templates](https://usenaive.ai/docs/api-reference/templates/list-templates.md) - [Get tenant subscription](https://usenaive.ai/docs/api-reference/tenant-billing/get-tenant-subscription.md) - [Set tenant subscription](https://usenaive.ai/docs/api-reference/tenant-billing/set-tenant-subscription.md) - [Tenant usage](https://usenaive.ai/docs/api-reference/tenant-billing/tenant-usage.md) - [Cancel order](https://usenaive.ai/docs/api-reference/trading/cancel-order.md): Cancel an open order. Approval-gated. - [Close position](https://usenaive.ai/docs/api-reference/trading/close-position.md): Close/liquidate a position. Approval-gated. - [Connect brokerage](https://usenaive.ai/docs/api-reference/trading/connect-brokerage.md): Begin Alpaca OAuth and return the authorize URL. - [Disconnect brokerage](https://usenaive.ai/docs/api-reference/trading/disconnect-brokerage.md) - [Get account](https://usenaive.ai/docs/api-reference/trading/get-account.md) - [Get order](https://usenaive.ai/docs/api-reference/trading/get-order.md) - [Get position](https://usenaive.ai/docs/api-reference/trading/get-position.md) - [List assets](https://usenaive.ai/docs/api-reference/trading/list-assets.md) - [List connections](https://usenaive.ai/docs/api-reference/trading/list-connections.md) - [List orders](https://usenaive.ai/docs/api-reference/trading/list-orders.md) - [List positions](https://usenaive.ai/docs/api-reference/trading/list-positions.md) - [Market data](https://usenaive.ai/docs/api-reference/trading/market-data.md) - [Place order](https://usenaive.ai/docs/api-reference/trading/place-order.md): Place a brokerage order. Approval-gated. Provide either `qty` or `notional`. - [Create tenant user](https://usenaive.ai/docs/api-reference/users/create-tenant-user.md): Create a tenant user under an account kit (explicit or the company default). - [Delete tenant user](https://usenaive.ai/docs/api-reference/users/delete-tenant-user.md): Soft-delete (suspend) a tenant user. The default user cannot be deleted. - [Get company](https://usenaive.ai/docs/api-reference/users/get-company.md): Get the authenticated company's details. - [Get tenant user](https://usenaive.ai/docs/api-reference/users/get-tenant-user.md) - [List tenant users](https://usenaive.ai/docs/api-reference/users/list-tenant-users.md): List tenant users for the workspace. A default user always exists. - [Update company](https://usenaive.ai/docs/api-reference/users/update-company.md): Update the company name, description, or settings. - [Update tenant user](https://usenaive.ai/docs/api-reference/users/update-tenant-user.md) - [Delete secret](https://usenaive.ai/docs/api-reference/vault/delete-secret.md) - [List vault entries](https://usenaive.ai/docs/api-reference/vault/list-vault-entries.md): List vault entries with masked values. Expired entries are excluded. - [Reveal secret](https://usenaive.ai/docs/api-reference/vault/reveal-secret.md): Decrypt and return the secret value in the response body. The reveal is audited. - [Rotate secret encryption](https://usenaive.ai/docs/api-reference/vault/rotate-secret-encryption.md): Re-wrap the KMS DEK, or perform full DEK regeneration + value re-encryption with `regenerate_dek`. - [Store secret](https://usenaive.ai/docs/api-reference/vault/store-secret.md): Store or replace an envelope-encrypted vault entry (AES-256-GCM + KMS-wrapped DEK). - [Complete member](https://usenaive.ai/docs/api-reference/verification/complete-member.md) - [Get verification](https://usenaive.ai/docs/api-reference/verification/get-verification.md) - [List verifications](https://usenaive.ai/docs/api-reference/verification/list-verifications.md) - [Resend member link](https://usenaive.ai/docs/api-reference/verification/resend-member-link.md) - [Start verification](https://usenaive.ai/docs/api-reference/verification/start-verification.md): Start KYC identity verification for company members via Footprint. Approval-gated for non-default agent callers. - [Generate video](https://usenaive.ai/docs/api-reference/video/generate-video.md): Queue an async fal.ai video generation job. Credits are charged on completion only. - [Get video job](https://usenaive.ai/docs/api-reference/video/get-video-job.md) - [List video models](https://usenaive.ai/docs/api-reference/video/list-video-models.md) - [Video pricing](https://usenaive.ai/docs/api-reference/video/video-pricing.md) - [Create webhook subscription](https://usenaive.ai/docs/api-reference/webhooks/create-webhook-subscription.md): Create a webhook subscription. The signing secret is returned once on creation. - [Delete webhook](https://usenaive.ai/docs/api-reference/webhooks/delete-webhook.md) - [List event types](https://usenaive.ai/docs/api-reference/webhooks/list-event-types.md) - [List webhook subscriptions](https://usenaive.ai/docs/api-reference/webhooks/list-webhook-subscriptions.md) - [Test webhook](https://usenaive.ai/docs/api-reference/webhooks/test-webhook.md) - [AccountKits](https://usenaive.ai/docs/architecture/account-kits.md): Policy templates that govern what a tenant user's agents can do. - [Approvals (governance)](https://usenaive.ai/docs/architecture/approvals.md): How human-in-the-loop approval is enforced and executed. - [Apps Infrastructure](https://usenaive.ai/docs/architecture/apps.md): How the apps primitive provisions managed hosting and a managed backend — provisioning, deploys, credentials, and scoped provider proxies. - [Connection status & webhooks](https://usenaive.ai/docs/architecture/connection-webhooks.md): The connections mirror, webhook ingress, lazy reconcile, and the last-write-wins guard. - [Governance Gateway](https://usenaive.ai/docs/architecture/governance-gateway.md): The credential-injection policy proxy at the tool-call boundary — caps, approvals, audit, revoke. - [Multi-tenancy](https://usenaive.ai/docs/architecture/multi-tenancy.md): How Naïve models accounts, agent profiles (per-tenant bundles), and AccountKits. - [Open-core boundary](https://usenaive.ai/docs/architecture/open-core.md): What's open source vs first-party — drawn on "are we the regulated counterparty," not "do we host it." - [Provisioning Workflow](https://usenaive.ai/docs/architecture/provisioning-workflow.md): How per-tenant agent profiles are provisioned as a durable, idempotent, async-native workflow. - [Sessions](https://usenaive.ai/docs/architecture/sessions.md): TTL'd, revocable per-user MCP sessions — bearer in header, never URL. - [Subject resolution](https://usenaive.ai/docs/architecture/subject-resolution.md): How Naive resolves which tenant user a request acts on — and the cross-tenant guard. - [Vault encryption](https://usenaive.ai/docs/architecture/vault-encryption.md): Envelope encryption with a managed KMS and per-tenant EncryptionContext binding. - [account-kits](https://usenaive.ai/docs/cli/account-kits.md): Manage AccountKits from the CLI. - [aeo](https://usenaive.ai/docs/cli/aeo.md): AI search optimization — LLM responses, mentions tracking, and AI keyword data via the CLI. - [app-data](https://usenaive.ai/docs/cli/app-data.md): App rankings, reviews, and metadata from Google Play and App Store via the CLI. - [approvals](https://usenaive.ai/docs/cli/approvals.md): Review & resolve agent-requested approvals from the CLI. - [Apps](https://usenaive.ai/docs/cli/apps.md): Manage web applications — create, deploy, publish, and configure managed apps with optional managed backends. - [Billing](https://usenaive.ai/docs/cli/billing.md): Manage subscriptions, plans, and credit top-ups from the CLI - [browser](https://usenaive.ai/docs/cli/browser.md): Drive a live cloud browser session step by step, and run autonomous signup/login backed by the credential vault. - [Cards](https://usenaive.ai/docs/cli/cards.md): Manage virtual cards — create, fund, assign, and track transactions from the CLI - [CEO Agent](https://usenaive.ai/docs/cli/ceo.md): Communicate with the CEO agent — run prompts, send messages, stream real-time output, and monitor sessions. - [clips](https://usenaive.ai/docs/cli/clips.md): Extract clips from YouTube videos and edit videos with captions and effects. - [compute](https://usenaive.ai/docs/cli/compute.md): naive compute — run Docker containers, background workers, and scheduled jobs on managed cloud compute. - [connections](https://usenaive.ai/docs/cli/connections.md): 3rd-party connections from the CLI. - [Cron Jobs](https://usenaive.ai/docs/cli/cron-jobs.md): Schedule recurring jobs — create, list, trigger, pause, and remove automated scheduled tasks. - [domains](https://usenaive.ai/docs/cli/domains.md): Manage email domains — list, connect, verify, search, purchase, and edit DNS records on the live zone. - [ecommerce](https://usenaive.ai/docs/cli/ecommerce.md): Product listings, pricing, sellers, and reviews from Google Shopping and Amazon via the CLI. - [email](https://usenaive.ai/docs/cli/email.md): Send and manage emails using provisioned inboxes — identity-aware with structured agent output. - [Employees](https://usenaive.ai/docs/cli/employees.md): Manage AI employees — hire, fire, configure, and list your autonomous workforce. - [Formation](https://usenaive.ai/docs/cli/formation.md): Company formation (LLC incorporation) — NAICS codes, submit, track status, download documents. - [identity](https://usenaive.ai/docs/cli/identity.md): View agent identity, provisioned resources, and available email inboxes. - [images](https://usenaive.ai/docs/cli/images.md): Generate AI images or search stock photos — with full parameter passthrough. - [jobs](https://usenaive.ai/docs/cli/jobs.md): Monitor and manage async jobs (image/video generation, deep research) with structured output. - [llm](https://usenaive.ai/docs/cli/llm.md): Run LLM chat completions through OpenRouter (300+ models) from the CLI. - [logs](https://usenaive.ai/docs/cli/logs.md): Activity logs from the CLI. - [media](https://usenaive.ai/docs/cli/media.md): Upload, list, update, and delete media assets in the Media Asset Manager. - [Memory](https://usenaive.ai/docs/cli/memory.md): Manage persistent agent memory — add, list, and remove facts and preferences that persist across sessions. - [mobile](https://usenaive.ai/docs/cli/mobile.md): naive mobile — provision, control & display cloud mobile emulators/devices via Mobilerun, run agent tasks, and call any Mobilerun API. - [Objectives](https://usenaive.ai/docs/cli/objectives.md): Manage strategic objectives — high-level goals that decompose into tasks on the kanban board. - [CLI Overview](https://usenaive.ai/docs/cli/overview.md): The naive CLI — an agent-native command-line toolkit for email, search, AI generation, and business operations. - [Phone](https://usenaive.ai/docs/cli/phone.md): Provision phone numbers and send/receive SMS (Surge) from the CLI - [queue](https://usenaive.ai/docs/cli/queue.md): naive queue — durable message queues (Amazon SQS) for agent work pipelines. - [register / login / link](https://usenaive.ai/docs/cli/register.md): Create, authenticate, or link a Naive account from the CLI. - [reviews](https://usenaive.ai/docs/cli/reviews.md): Reviews and reputation primitives via CLI: Google, Trustpilot, TripAdvisor, and social engagement. - [search](https://usenaive.ai/docs/cli/search.md): Web search, URL extraction, and deep multi-source research with structured agent output. - [seo](https://usenaive.ai/docs/cli/seo.md): Keyword research, backlink analysis, and competitive intelligence from the CLI. - [social](https://usenaive.ai/docs/cli/social.md): Social media — connect accounts, create posts, schedule content, view analytics. - [Tasks](https://usenaive.ai/docs/cli/tasks.md): Kanban task management — list, create, complete, block, and dispatch tasks across your AI workforce. - [Trading](https://usenaive.ai/docs/cli/trading.md): Link a brokerage account via OAuth and trade stocks, options & crypto from the CLI. - [travel](https://usenaive.ai/docs/cli/travel.md): Travel discovery primitives via CLI: Google Hotels and TripAdvisor search. - [use](https://usenaive.ai/docs/cli/use.md): Set the active tenant user for CLI commands. - [users](https://usenaive.ai/docs/cli/users.md): Manage tenant users from the CLI. - [vault](https://usenaive.ai/docs/cli/vault.md): Per-user Credential Vault from the CLI. - [Verification](https://usenaive.ai/docs/cli/verification.md): Identity verification (KYC) for company founders/members — start, track, complete, and resend. - [video](https://usenaive.ai/docs/cli/video.md): Generate AI videos — text-to-video and image-to-video with async job processing. - [Account Kits](https://usenaive.ai/docs/getting-started/account-kits.md): Policy templates that bundle which primitives are enabled and which third-party apps a user may connect — assign users to a kit instead of configuring each one. - [GEO/AEO](https://usenaive.ai/docs/getting-started/aeo.md): AI search optimization data - LLM responses, mentions tracking, AI keyword volume, and ChatGPT scraping. - [Agent Profiles](https://usenaive.ai/docs/getting-started/agent-profiles.md): The governed real-world bundle — identity, money, comms, and runtime, per tenant. - [Mobile App Data](https://usenaive.ai/docs/getting-started/app-data.md): App rankings, reviews, and metadata from Google Play and the Apple App Store. - [Approvals](https://usenaive.ai/docs/getting-started/approvals.md): Human-in-the-loop approval for sensitive agent actions — the API freezes a gated request and replays it once a human approves. - [Apps](https://usenaive.ai/docs/getting-started/apps.md): Web applications — managed Next.js apps with an optional managed backend. Build locally and deploy directly, or let AI engineer agents build for you. - [Auth](https://usenaive.ai/docs/getting-started/auth.md): End-user authentication for your app or your users' apps — auth config and admin user management on a fullstack app's managed backend. - [Authentication](https://usenaive.ai/docs/getting-started/authentication.md): API keys, Bearer token auth, onboarding flows, and error handling. - [Billing & Credits](https://usenaive.ai/docs/getting-started/billing.md): Manage subscriptions, purchase credits, and understand pricing - [Browser](https://usenaive.ai/docs/getting-started/browser.md): Cloud browser sessions your agents drive — navigate, act, extract — plus autonomous signup/login that generates and vaults credentials, with a human live view. - [Virtual Cards](https://usenaive.ai/docs/getting-started/cards.md): Issue virtual payment cards (managed virtual cards or prepaid gift cards prepaid), fund via checkout, assign to agents, and track transactions. - [Video Clipping](https://usenaive.ai/docs/getting-started/clips.md): Turn a long video into distribution-ready short-form clips with AI transcription, virality scoring, captions, and 9:16 reframing. - [Compute](https://usenaive.ai/docs/getting-started/compute.md): Run your own Docker containers, background workers, and scheduled jobs on managed cloud compute — without ever holding a cloud key. - [Connections](https://usenaive.ai/docs/getting-started/connections.md): 3rd-party app access — per user, governed by the Account Kit. Connect Gmail, Slack, GitHub, Stripe, Notion and 1,000+ apps for each of your end-users. - [Credits](https://usenaive.ai/docs/getting-started/credits.md): Usage-based billing — how credits work, costs per operation, sync vs async charging. - [Customer Billing](https://usenaive.ai/docs/getting-started/customer-billing.md): Bill and rate-limit your own end-customers — plans mapped to Account Kits, per-tenant subscriptions, metered usage, and quota enforcement. - [Database](https://usenaive.ai/docs/getting-started/database.md): Managed Postgres for your app or your users' apps — raw SQL, REST CRUD, and migrations on a fullstack app's managed backend. - [Domain Management](https://usenaive.ai/docs/getting-started/domains.md): System domains, custom (BYOD) domains, and domain purchasing — register, verify DNS, buy new domains, and manage the foundation of your email identity. - [E-commerce Data](https://usenaive.ai/docs/getting-started/ecommerce.md): Product listings, pricing, sellers, and reviews from Google Shopping and Amazon. - [Email](https://usenaive.ai/docs/getting-started/email.md): The email primitive — create inboxes, send and receive mail through identity-aware addresses on your company's domain. - [Company Formation](https://usenaive.ai/docs/getting-started/formation.md): Incorporate an LLC end-to-end — submit formation with KYC-verified founders, track status, and download documents. - [Edge Functions](https://usenaive.ai/docs/getting-started/functions.md): Serverless edge functions for your app or your users' apps — list, deploy, and invoke on a fullstack app's managed backend. - [Infrastructure as Code](https://usenaive.ai/docs/getting-started/iac.md): Declare shared infrastructure, business programs, and agent blueprints in naive.config.ts. - [Image Generation](https://usenaive.ai/docs/getting-started/images.md): Two visual primitives: AI image generation and free stock photo search. - [Introduction](https://usenaive.ai/docs/getting-started/introduction.md): Naïve gives every AI agent its own governed real-world agent profile — verified identity, a spend-capped card, comms, and a runtime, per tenant. - [Jobs](https://usenaive.ai/docs/getting-started/jobs.md): Unified async job tracking for all long-running operations. - [LLM](https://usenaive.ai/docs/getting-started/llm.md): OpenRouter-backed LLM routing — chat completions across 300+ models through one Naive endpoint, billed in credits. Use Naive as a full wrapper over OpenRouter. - [Logs](https://usenaive.ai/docs/getting-started/logs.md): Per-user activity audit trail — every primitive write and connection action emits an event you can query per-user or across all users, and stream live. - [Media Asset Management](https://usenaive.ai/docs/getting-started/media.md): Upload, organize, and manage media assets. Auto-populated from video clipping and generation jobs. - [Mobile](https://usenaive.ai/docs/getting-started/mobile.md): Provision, control, and display cloud mobile emulators/devices via Mobilerun — run natural-language agent tasks, stream the live screen, and call any Mobilerun API — without ever holding a Mobilerun key. - [Orchestration](https://usenaive.ai/docs/getting-started/orchestration.md): AI workforce orchestration — CEO agent, kanban tasks, objectives, employees, cron scheduling, and persistent memory. - [Phone Numbers & SMS](https://usenaive.ai/docs/getting-started/phone.md): Provision US phone numbers and send/receive SMS via Surge — carrier-registered (10DLC), with inbound webhooks and agent assignment. - [Queue](https://usenaive.ai/docs/getting-started/queue.md): Durable message queues (Amazon SQS) for agent work pipelines — the natural pairing for compute workers. - [Quickstart](https://usenaive.ai/docs/getting-started/quickstart.md): Make your first Naïve call — SDK, CLI, or MCP. - [Reviews](https://usenaive.ai/docs/getting-started/reviews.md): Reputation and review intelligence from Google, Trustpilot, TripAdvisor, and social engagement signals. - [Runtime & Hosting](https://usenaive.ai/docs/getting-started/runtime.md): Run the agent on your own infra (the lead path) or on Naïve-hosted microVMs. - [Web Research](https://usenaive.ai/docs/getting-started/search.md): Three research tools at different depths — web search, URL extraction, and multi-step deep research with citations. - [SEO](https://usenaive.ai/docs/getting-started/seo.md): Keyword research, backlink analysis, and competitive intelligence covering Google, Bing, Amazon, and Google Trends. - [Sessions](https://usenaive.ai/docs/getting-started/sessions.md): Short-lived, revocable MCP sessions scoped to a single tenant user — hand an agent a fused native + third-party toolset without sharing your workspace key. - [Social Media](https://usenaive.ai/docs/getting-started/social.md): Post to 10+ social platforms — connect accounts, create posts, schedule content, and track analytics. - [Storage](https://usenaive.ai/docs/getting-started/storage.md): File storage buckets and objects for your app or your users' apps — backed by a fullstack app's managed storage. - [Business Templates](https://usenaive.ai/docs/getting-started/templates.md): Pre-built company templates with agents, tasks, and apps — apply a template to bootstrap a fully staffed company in seconds. - [Trading](https://usenaive.ai/docs/getting-started/trading.md): Link a brokerage account via OAuth and trade stocks, options, and crypto — account, assets, positions, orders, and market data, with human-in-the-loop approval on money-moving actions. - [Travel](https://usenaive.ai/docs/getting-started/travel.md): Travel discovery and hotel intelligence from Google Hotels and TripAdvisor. - [Users](https://usenaive.ai/docs/getting-started/users.md): Tenant users — the end-users you provision Naive resources for. Every primitive (cards, inboxes, vault, connections) is scoped to a tenant user. - [Vault](https://usenaive.ai/docs/getting-started/vault.md): Per-user encrypted key/value storage for agent-held secrets — envelope-encrypted with a managed KMS, with locked, expiring, and rotatable entries. - [Identity Verification](https://usenaive.ai/docs/getting-started/verification.md): KYC identity verification for company founders/members — hosted links, email delivery, and real-time status tracking. - [Video Generation](https://usenaive.ai/docs/getting-started/video.md): Generate video — text-to-video and image-to-video using models like Kling, Minimax, and Wan. - [Webhooks](https://usenaive.ai/docs/getting-started/webhooks.md): Per-tenant outbound event subscriptions — receive signed, retried HTTP callbacks when Naive events fire. - [Connection Guide](https://usenaive.ai/docs/mcp/connection.md): How to connect different MCP clients to the Naive hosted server. - [MCP Server](https://usenaive.ai/docs/mcp/overview.md): Hosted Model Context Protocol server — connect Claude, Cursor, or any MCP client. - [MCP Tools](https://usenaive.ai/docs/mcp/tools.md): All available MCP tools in the Naive API v2 hosted server. - [Agent tools](https://usenaive.ai/docs/sdk/agent-tools.md): Drop Naive's capabilities into a Claude (or any LLM) tool-use loop with one call. - [Errors](https://usenaive.ai/docs/sdk/errors.md): The typed NaiveError thrown by every SDK method. - [Install](https://usenaive.ai/docs/sdk/install.md): Install and initialize @usenaive-sdk/node. - [SDK Overview](https://usenaive.ai/docs/sdk/overview.md): The Naïve SDK — provision and govern a real-world agent profile per tenant. - [SDK Quickstart](https://usenaive.ai/docs/sdk/quickstart.md): Solo and multi-tenant flows with the SDK. - [Sessions](https://usenaive.ai/docs/sdk/sessions.md): Per-user MCP sessions via the SDK. - [accountKits](https://usenaive.ai/docs/sdk/sub-clients/account-kits.md): Control-plane CRUD for AccountKits (root client only). - [aeo](https://usenaive.ai/docs/sdk/sub-clients/aeo.md): AI-search / GEO visibility — LLM responses, mention metrics and AI keyword volume. - [approvals](https://usenaive.ai/docs/sdk/sub-clients/approvals.md): Human-in-the-loop queue for sensitive agent actions. - [apps](https://usenaive.ai/docs/sdk/sub-clients/apps.md): Provision and manage managed apps with an optional managed backend. - [auth](https://usenaive.ai/docs/sdk/sub-clients/auth.md): End-user auth config and admin user management on a fullstack app's managed backend. - [billing](https://usenaive.ai/docs/sdk/sub-clients/billing.md): Per-tenant plans, subscriptions, metered usage and quotas for your end-customers. - [browser](https://usenaive.ai/docs/sdk/sub-clients/browser.md): Cloud browser sessions and autonomous signup/login. - [cards](https://usenaive.ai/docs/sdk/sub-clients/cards.md): Per-user virtual cards. - [compute](https://usenaive.ai/docs/sdk/sub-clients/compute.md): Run Docker containers, background workers, and scheduled jobs on managed cloud compute. - [connections](https://usenaive.ai/docs/sdk/sub-clients/connections.md): Per-user 3rd-party connections. - [cron](https://usenaive.ai/docs/sdk/sub-clients/cron.md): Scheduled recurring agent jobs (Hermes gateway). - [database](https://usenaive.ai/docs/sdk/sub-clients/database.md): Managed Postgres on a fullstack app — SQL, REST CRUD, and migrations. - [domains](https://usenaive.ai/docs/sdk/sub-clients/domains.md): Per-user domains. - [email](https://usenaive.ai/docs/sdk/sub-clients/email.md): Per-user inboxes + sending. - [formation](https://usenaive.ai/docs/sdk/sub-clients/formation.md): Per-user US company formation. - [functions](https://usenaive.ai/docs/sdk/sub-clients/functions.md): List, invoke, and deploy edge functions on a fullstack app. - [jobs](https://usenaive.ai/docs/sdk/sub-clients/jobs.md): Unified async job tracking (images, video, research, data tasks). - [llm](https://usenaive.ai/docs/sdk/sub-clients/llm.md): OpenRouter-backed chat completions — a full wrapper over OpenRouter. - [logs](https://usenaive.ai/docs/sdk/sub-clients/logs.md): Per-user activity events. - [memory](https://usenaive.ai/docs/sdk/sub-clients/memory.md): Persistent long-term agent memory. - [mobile](https://usenaive.ai/docs/sdk/sub-clients/mobile.md): Provision, control & display cloud mobile emulators/devices via Mobilerun — run agent tasks, stream the live screen, and call any Mobilerun API. - [phone](https://usenaive.ai/docs/sdk/sub-clients/phone.md): Per-user phone numbers + SMS (Surge). - [profile](https://usenaive.ai/docs/sdk/sub-clients/profile.md): Read and set the tenant user's own profile email. - [queue](https://usenaive.ai/docs/sdk/sub-clients/queue.md): Durable work queues (Amazon SQS) for agent pipelines — standard & FIFO, with dead-letter queues. - [seo](https://usenaive.ai/docs/sdk/sub-clients/seo.md): Keyword research, rank tracking, backlinks and competitor analysis (DataForSEO-backed). - [social](https://usenaive.ai/docs/sdk/sub-clients/social.md): Per-user social posting. - [storage](https://usenaive.ai/docs/sdk/sub-clients/storage.md): File storage buckets and objects on a fullstack app's managed backend. - [trading](https://usenaive.ai/docs/sdk/sub-clients/trading.md): Per-user brokerage trading (stocks, options, crypto) via OAuth. - [users](https://usenaive.ai/docs/sdk/sub-clients/users.md): Control-plane CRUD for tenant users (root client only). - [vault](https://usenaive.ai/docs/sdk/sub-clients/vault.md): Per-user encrypted key/value storage. - [verification](https://usenaive.ai/docs/sdk/sub-clients/verification.md): Per-user KYC verification. - [webhooks](https://usenaive.ai/docs/sdk/sub-clients/webhooks.md): Per-tenant outbound event subscriptions — signed, retried delivery. - [Types](https://usenaive.ai/docs/sdk/types.md): Exported TypeScript types. ## OpenAPI Specs - [openapi](https://usenaive.ai/docs/api-reference/openapi.json)