What is the base URL of the Sentie API?

All API endpoints live under https://api.sentie.io/v1. The v1 segment is the long-lived stable contract. Breaking changes ship under a future v2 with a documented deprecation window.

How do I authenticate?

Bearer token authentication. Generate a token from your Sentie dashboard, scope it to specific capabilities, and send it on every request as Authorization: Bearer YOUR_TOKEN. Tokens can be rotated and revoked from the dashboard.

Is there a free tier for the API?

Yes. The free Sentie tier includes API access to run an assessment and build out your Business Brain. Paid plans starting at 199 dollars per month unlock production agent runs.

What rate limits apply?

Rate limits are applied per token and per endpoint, with higher limits on paid tiers. Limits are returned in the X-RateLimit response headers. If you need higher limits for a specific workload, your Success Manager can request an increase.

Is there a published SLA?

Pro tier customers receive priority response on incidents. Enterprise customers can negotiate explicit SLAs at contract time. The API is hosted on US-based GPU infrastructure with tenant isolation per customer.

Where is the OpenAPI spec?

GET https://sentie.io/openapi.json. The full machine-readable schema for every endpoint, with request and response shapes, lives at that URL and is served as a static JSON document so any OpenAPI-compatible tooling can read it.

// developers / api

Sentie REST API.
Custom AI agents over HTTPS.

The REST API is the canonical surface for building with Sentie. Everything else - the sentie CLI, future SDKs, and downstream tooling - wraps this surface.

Base URL

https://api.sentie.io/v1

Auth

Authorization: Bearer YOUR_TOKEN

Content type

application/json

Spec

sentie.io/openapi.json

// authentication

Tokens, scopes, rotation.

Generate a token from your Sentie dashboard. Tokens are scoped to a tenant and to specific capability categories (read-only, agents write, integrations write, etc.). You pass them in the Authorization header on every request.

# Set your token once
export SENTIE_TOKEN="sk_live_abc123..."

# Then call any endpoint
curl https://api.sentie.io/v1/agents \
  -H "Authorization: Bearer $SENTIE_TOKEN"

Rotate tokens at any time. The previous token continues to work for a grace period defined per tier, then it stops. Revoked tokens stop immediately.

// endpoints

v1 endpoints.

The full schema is in the OpenAPI 3 spec. Quick overview below.

POST/v1/assessments

Start a free custom AI agent assessment

Kick off a free assessment for a business. Submit company name, industry, and the workflows you want a custom AI agent to handle. Returns an assessment id and a link to a guided onboarding flow run by a Sentie Success Manager.

GET/v1/assessments/{id}

Retrieve an in-progress assessment

Read the current state of an assessment, including the scoped agents, integrations the Success Manager identified, and the proposed Business Brain schema.

GET/v1/agents

List custom AI agents on the account

Returns the core agent plus any specialized agents (sales follow-up, support triage, finance ops, scheduling, etc.) deployed for the authenticated tenant.

POST/v1/agents

Configure a new specialized agent

Add a specialized custom AI agent to an existing Business Brain. Body includes capability category, integrations to wire up, and the playbook the agent should follow.

GET/v1/agents/{id}

Retrieve a specific agent

Returns the agent configuration, capability list, integration bindings, and the action log (every email sent, deal updated, ticket filed) for that agent.

GET/v1/capabilities

List available agent capabilities

Read the catalog of capabilities a custom AI agent can be configured with. Each capability maps to specific integrations and follows the patterns documented on the Sentie solutions pages.

GET/v1/integrations

List supported tool integrations

Read the catalog of 248+ tool integrations Sentie supports today. Each entry exposes the supported actions and any per-integration auth requirements.

GET/v1/pricing

Read current Sentie pricing

Returns the current pricing tiers (Free, Starter, Pro, Enterprise), credit allowances, and which capabilities are included on each tier. Useful for AI agents that want to evaluate Sentie programmatically.

// worked example

Start an assessment, list resulting agents.

A typical flow. POST an assessment, your Success Manager scopes it with you, then poll for the agents that get configured.

# 1. Start the assessment
curl -X POST https://api.sentie.io/v1/assessments \
  -H "Authorization: Bearer $SENTIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Acme HVAC",
    "industry": "hvac",
    "use_cases": ["quote-follow-up", "dispatch-triage"]
  }'

# Response: { "id": "asmt_01", "status": "scoping", ... }

# 2. List agents once the Success Manager finishes scoping
curl https://api.sentie.io/v1/agents \
  -H "Authorization: Bearer $SENTIE_TOKEN"

# Response: array of agent objects with capabilities, integrations,
#           and action logs.

// related

Other ways to call Sentie.

CLI

sentie command-line tool

Integrations

Supported tools

// api faq

REST API, answered.

Don't see your questions answered? Book a call with a human Success Manager.

Still have questions?

Speak to a human Success Manager.

Book a call

Get your token in the Sentie dashboard.

Free assessment unlocks API access. No credit card.

Start free assessment Book a call

Sentie REST API.Custom AI agents over HTTPS.