Install Jentic One Beta

Connect the Orsay AI API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Orsay AI API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Forsay.ai%2Forsay" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Forsay.ai%2Forsay" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Orsay AI API.

List and inspect AI agent configurations through GET /v1/agents and GET /v1/agents/{agent_id}

Send messages from a configured agent into a conversation via POST /v1/agents/{agent_id}/message

Retrieve full conversation history and search across conversations using GET /v1/conversations and GET /v1/conversations/search-index

Connect Instagram and WhatsApp accounts through POST /v1/integrations/instagram/account and POST /v1/integrations/whatsapp/account

GET STARTED

Start building with Orsay AI API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Orsay AI API for, with concrete tasks.

★ Instagram DM Lead Qualification

Brands receiving high inbound DM volume on Instagram can configure an Orsay agent to qualify leads in chat, ask discovery questions, and route hot prospects to a human. The integrations endpoints connect the Instagram account, and the agent endpoints drive the actual conversation through POST /v1/agents/{agent_id}/message.

POST /v1/integrations/instagram/account to connect, then POST /v1/agents/{agent_id}/message to reply to inbound DMs with qualification questions.

WhatsApp Outbound Sequences

Teams running paid acquisition into WhatsApp can use Orsay's sequence endpoints to deliver multi-step nurture flows that branch on response. POST /v1/sequences creates the sequence definition and POST /v1/agents/{agent_id}/message handles per-step delivery, with handoff to humans on conversion signals.

POST /v1/sequences with a 3-step welcome flow, then enroll new leads via the sequence enrollment endpoint and let the agent run delivery.

Human Handoff on Buy Intent

When a conversation shows buy intent, the agent should step back. PATCH /v1/conversation/{lead_id}/ai disables the AI on that thread so a human seller takes over without losing chat context, and GET /v1/lead/{lead_id} surfaces the full lead profile for the human's first reply.

PATCH /v1/conversation/{lead_id}/ai with enabled=false when intent score crosses threshold, then GET /v1/lead/{lead_id} for the human seller's briefing.

Conversation Export for Analytics

Operations teams want full conversation data in their warehouse to compute per-agent close rate or train on real exchanges. POST /v1/conversations/export starts a job and the GET /v1/conversations/export/{job_id}/download endpoint returns the file for ETL.

POST /v1/conversations/export, poll GET /v1/conversations/export/{job_id}/status, then download via the /download endpoint.

Agent-Driven Conversational Sales via Jentic

Sales-ops agents orchestrating multiple channels can drive Orsay through Jentic without learning all 33 endpoints. Jentic exposes the operations by intent and isolates the bearer token in the vault, letting another agent handle CRM updates while Orsay handles the chat.

Use Jentic to search 'send a message via my AI sales agent', load the POST /v1/agents/{agent_id}/message schema, and execute with the conversation id and message body.

Key Endpoints

33 endpoints — jentic publishes the only available openapi specification for orsay ai api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/v1/conversations

List conversations across the workspace

GET

/v1/lead/{lead_id}

Retrieve the lead behind a conversation

POST

/v1/agents/{agent_id}/message

Send a message via an AI agent

PATCH

/v1/conversation/{lead_id}/ai

Pause or resume the AI on a conversation

POST

/v1/integrations/instagram/account

Connect an Instagram account

POST

/v1/integrations/whatsapp/account

Connect a WhatsApp account

POST

/v1/sequences

Create a multi-step outreach sequence

POST

/v1/conversations/export

Start a conversation export job

GET

/v1/conversations

List conversations across the workspace

GET

/v1/lead/{lead_id}

Retrieve the lead behind a conversation

POST

/v1/agents/{agent_id}/message

Send a message via an AI agent

PATCH

/v1/conversation/{lead_id}/ai

Pause or resume the AI on a conversation

POST

/v1/integrations/instagram/account

Connect an Instagram account

POST

/v1/integrations/whatsapp/account

Connect a WhatsApp account

POST

/v1/sequences

Create a multi-step outreach sequence

POST

/v1/conversations/export

Start a conversation export job

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Orsay AI API by hand means setting up its bearer auth and mapping the conversation, lead, agent, and Instagram and WhatsApp integration routes yourself. Through Jentic you install once, import Orsay AI from the API Directory, store the token once, and your agent calls it.

Permission scoping

Orsay AI puts the agent id in the URL path (/agents/{agent_id}/message), so a rule can pin your agent to one Orsay agent for sending messages. You choose the operations it may call, so connecting an Instagram or WhatsApp account or exporting conversations is not included unless you add it.

Credential isolation

Your Orsay AI bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'send a message in a conversation' or 'pause AI on a lead's conversation', and Jentic returns the matching Orsay AI operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Orsay AI API through Jentic.

Why is there no official OpenAPI spec for Orsay AI API?

Orsay AI publishes documentation on its docs site but not a maintained OpenAPI document. Jentic generates and maintains this spec so that AI agents and developers can call Orsay AI API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Orsay AI API use?

Orsay AI uses bearer-token authentication. Through Jentic the bearer token is stored encrypted in the vault and injected only at execution time, so the agent never sees the raw secret.

Can I connect a WhatsApp account through the Orsay AI API?

Yes. POST /v1/integrations/whatsapp/account creates the integration, GET /v1/integrations/whatsapp/account lists existing connections, and GET /v1/integrations/whatsapp/profiles enumerates the linked WhatsApp profiles.

What are the rate limits for the Orsay AI API?

The OpenAPI spec does not declare numeric rate limits. Messaging-channel rate limits (Instagram and WhatsApp) often dominate in practice - confirm Orsay's per-tenant limits with their team before scaling outbound volume.

How do I pause the AI on a conversation through Jentic?

Search Jentic for 'pause AI on a conversation', load the PATCH /v1/conversation/{lead_id}/ai schema, and execute with enabled set to false. The agent stops responding while the human takes over.

Does the Orsay AI API expose billing data?

Yes. GET /v1/billing/products, GET /v1/billing/subscriptions, and GET /v1/billing/wallets return the product catalogue, current subscription state, and wallet balance for the tenant.

Can I limit what my agent is allowed to do with the Orsay AI API?

Yes. Because you run Jentic One yourself, your own rules decide which Orsay AI operations and credentials the agent may use. Since Orsay puts the agent id in the URL path (POST /v1/agents/{agent_id}/message), you can pin your agent to a single Orsay agent for sending messages, and you choose exactly which operations it may call. That means higher-impact actions like connecting an Instagram or WhatsApp account or exporting conversations are excluded unless you explicitly allow them.

Orsay AI API

AI ReadinessAI-Aware (A-)74/100

See full scorecard

Agent-ready OpenAPI document · curated by JenticAI/MLLanguage Modelsbearer33 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Run AI sales agents over Instagram and WhatsApp, manage conversations and leads, and orchestrate follow-up sequences through the Orsay AI platform.

Use for: List all conversations my AI agent is managing, Send a follow-up message in an active Instagram conversation, Connect a new WhatsApp account to my Orsay agent, Retrieve the lead profile behind a conversation

Not supported: Does not handle payment processing, ad campaign management, or SMS/email channels - use for AI-driven Instagram and WhatsApp conversations only.

Jentic publishes the only available OpenAPI specification for Orsay AI API, keeping it validated and agent-ready. Orsay AI is a conversational-commerce platform that lets brands run AI agents over Instagram and WhatsApp to qualify leads, hold sales conversations, and execute follow-up sequences. The 33 endpoints span agent management, conversation history, lead context, integrations with Instagram and WhatsApp accounts, message-level feedback, sequence orchestration, organization configuration, and billing. It targets sales and customer-acquisition teams that want to automate first-touch outreach while keeping humans in the loop for handover.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4

98%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: CSignals: 4

65%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

56%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: A-Signals: 1

75%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

100

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A+Signals: 1

100%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the Orsay AI API to your agent

Capabilities

Start building with Orsay AI API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Orsay AI API

Jentic AI Readiness Score

Orsay AI API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness