canonical: https://jentic.com/apis/andromeda-intelligence.com/andromeda-intelligence

# Andromeda Intelligence Cynthia AI API

Jentic publishes the only available OpenAPI specification for Cynthia AI API, keeping it validated and agent-ready. Cynthia AI from Andromeda Intelligence is a review-management service that exposes a small Zapier-flavoured integration surface for exchanging tokens, validating credentials, and receiving review payloads from automation pipelines. The API is built around three operations that let external workflows authenticate and push review records into the Cynthia platform for downstream AI-driven analysis. It is intended as a glue layer between Zapier-style triggers and Cynthia's review pipeline rather than a general-purpose search or analytics endpoint.

## For AI agents

Authenticate Zapier-style integrations with Cynthia AI and forward review payloads into its analysis pipeline through three bearer-secured endpoints.

## Scope

Does not handle review collection, moderation, or display, and does not run the AI analysis itself - use for forwarding Zapier-triggered review payloads into Cynthia's pipeline only.

## Capabilities

- Exchange short-lived Zapier credentials for a Cynthia AI bearer token
- Validate Zapier connection credentials before publishing review data
- Forward incoming review payloads from Zapier triggers into Cynthia's review pipeline
- Authenticate inbound automation traffic using bearer tokens issued by Cynthia
- Wire Zapier multi-step Zaps into Cynthia review ingestion without writing custom auth code

## Use cases

### Zapier Review Ingestion

Wire a Zapier Zap that watches an external review source (Google, Trustpilot, internal CRM) and forwards each new review into Cynthia AI for sentiment and topic analysis. The integration uses POST /zapier_token_exchange to obtain an access token, then POST /zapier_receive_data to deliver the review payload. Setup typically takes under an hour because Cynthia's three-endpoint surface maps directly onto a standard Zapier auth and action handler.

Example prompt: Call POST /zapier_token_exchange with the supplied OAuth code, store the returned bearer token, then POST /zapier_receive_data with a single review record and verify a 2xx response

### Zapier Credential Health Check

Periodically verify that a stored Cynthia AI integration is still authorised before a Zap fires by calling POST /zapier_test_credentials with the current bearer token. This avoids dropped review events when the token has been rotated or revoked and lets ops teams alert on broken connections instead of discovering them via missing data.

Example prompt: Call POST /zapier_test_credentials with the stored bearer token and surface a re-auth prompt if the response is non-2xx

### AI Agent Review Pipeline via Jentic

An AI agent that monitors brand reputation can pull new reviews from a source system and push them into Cynthia for AI-driven analysis without managing OAuth flows directly. Through Jentic the agent searches for the operation, loads the schema for /zapier_receive_data, and executes the call with a bearer token retrieved from the vault. This keeps Cynthia's bearer token isolated from the agent's prompt and tool context.

Example prompt: Search Jentic for 'forward a review to Cynthia AI', load POST /zapier_receive_data, and execute with a structured review payload sourced from the agent's monitoring tool

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/zapier_token_exchange` | Exchange Zapier OAuth code for a Cynthia bearer token |
| POST | `/zapier_test_credentials` | Validate stored Cynthia bearer token |
| POST | `/zapier_receive_data` | Forward an incoming review payload into Cynthia |

## Key resources

- **Authentication** — Token exchange and credential validation operations used by Zapier-style integrations
- **Reviews** — Inbound review payload delivery into Cynthia's analysis pipeline

## Why Jentic

- **Setup:** Wiring the Cynthia AI API by hand means running the Zapier token exchange, carrying the bearer token, and posting review payloads to the right endpoint yourself. Through Jentic you install once, import Cynthia AI from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Cynthia AI exposes only the token-exchange, credential-test, and data-receive endpoints, so scope the agent to the operations it needs, such as forwarding a review with zapier_receive_data. You choose the operations it may call, so credential exchange is not included unless you add it.
- **Credential handling:** Your Cynthia AI bearer token and Zapier OAuth code are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'forward a review to Cynthia AI', and Jentic returns the matching Cynthia operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **OpenAI API** — OpenAI provides the LLMs commonly used to analyse the review text Cynthia ingests.
- **Yotpo UGC API** — Yotpo UGC manages reviews and ratings end-to-end rather than acting as a Zapier ingestion layer.
- **LoyaltyLion API** — LoyaltyLion captures customer engagement events that often accompany review programs feeding Cynthia.

## FAQ

### Why is there no official OpenAPI spec for Cynthia AI API?

Andromeda Intelligence does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Cynthia 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 Cynthia AI API use?

Cynthia AI uses HTTP bearer authentication. Clients first call POST /zapier_token_exchange to convert a Zapier OAuth code into a bearer token, then send that token in the Authorization header on subsequent calls. Through Jentic the bearer token is stored in the encrypted vault and never injected into the agent's prompt context.

### Can I forward arbitrary review data with the Cynthia AI API?

Yes, the POST /zapier_receive_data endpoint accepts review payloads from a Zapier-triggered source. The schema is shaped around Zapier action handlers, so the most reliable integration path is via a Zap that already maps the source review fields into the expected request body.

### What are the rate limits for the Cynthia AI API?

The OpenAPI spec does not declare explicit rate limits. Treat the integration as best-effort and implement retry-with-backoff for non-2xx responses on /zapier_receive_data. Confirm production quotas with Andromeda Intelligence before sending high-volume traffic.

### How do I send a review through the Cynthia AI API via Jentic?

Run pip install jentic, then search Jentic for 'forward a review to Cynthia AI'. Jentic returns POST /zapier_receive_data with its input schema, loads the bearer credential from the vault, and executes the call with your review payload.

### Do I need to call the token exchange before every Cynthia request?

No. Call POST /zapier_token_exchange once to obtain a bearer token, then reuse it on subsequent /zapier_receive_data calls. Use POST /zapier_test_credentials periodically to confirm the token is still valid before high-volume runs.

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

Yes. Because you run Jentic One yourself, you decide which of Cynthia AI's three operations your agent may call, and your own rules govern which credentials it may use. If the agent only needs to forward reviews, you can scope it to POST /zapier_receive_data and leave out POST /zapier_token_exchange and POST /zapier_test_credentials, so credential exchange is not available unless you add it. The stored bearer token is injected only at execution time and never enters the agent's prompt or context.