Glean.ly API

Name: Glean.ly API
Brand: Glean.ly API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsProduct Analyticsbearer13 EndpointsREST

For Agents

Capture and read research artefacts — experiments, facts, insights, conclusions, themes, and labels — from a Glean.ly research repository.

Connect the Glean.ly API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Glean.ly 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.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 Glean.ly API.

Create, read, and update experiments and the facts captured against them

Record insights derived from research and link them to source experiments

Capture conclusions that synthesise insights into shippable decisions

Manage the themes, labels, and tags taxonomy used across the repository

GET STARTED

Start building with Glean.ly API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Glean.ly API for, with concrete tasks.

★ Survey Result Ingestion

Push structured survey findings into Glean.ly so the research team can theme and synthesise them. POST /api/experiment creates the experiment shell, POST /api/experiment/{id}/fact records each individual finding, and POST /api/insight captures the synthesised observation that downstream conclusions reference.

Create an experiment titled 'Pricing Survey Q2 2026', add 5 facts with respondent quotes, and post one insight tagged 'pricing'

Insight-to-Decision Audit Trail

Build an audit trail that connects shipped product decisions back to the research insights that supported them. Conclusions in Glean.ly link to the insights they synthesise, and the API exposes those edges so an agent can render a 'why we shipped this' page from the conclusion id alone.

Fetch conclusion id 7821 and return its title plus every linked insight id and source experiment

Taxonomy Maintenance

Keep the themes, labels, and tags vocabulary tidy across a growing repository. The /api/themes, /api/labels, and /api/tags endpoints let an agent enumerate the current taxonomy, detect duplicates or near-duplicates by string similarity, and re-tag artefacts that drift from the canonical names.

List every theme via /api/themes, group by lowercased name, and return any pair of themes whose names match after stripping whitespace

AI Agent Research Capture

Use Jentic to let an AI agent file new facts and insights into Glean.ly the moment a user shares them in chat. The agent issues an intent like 'log a research insight', Jentic resolves POST /api/insight, executes it with the OAuth Bearer token from the vault, and returns the new artefact id for confirmation.

Through Jentic, post an insight 'Users abandon checkout when shipping cost is hidden' linked to experiment id 9911 and return the new id

Key Endpoints

13 endpoints — the glean.

METHOD

PATH

DESCRIPTION

POST

/api/experiment

Create an experiment record

POST

/api/experiment/{id}/fact

Add a fact to an experiment

POST

/api/insight

Record an insight

POST

/api/conclusion

Record a conclusion linking insights

GET

/api/themes

List repository themes

GET

/api/labels

List repository labels

GET

/authorizeRoute

Begin the OAuth 2.0 authorisation flow

POST

/api/experiment

Create an experiment record

POST

/api/experiment/{id}/fact

Add a fact to an experiment

POST

/api/insight

Record an insight

POST

/api/conclusion

Record a conclusion linking insights

GET

/api/themes

List repository themes

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Glean.ly OAuth tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped execution token — the raw Bearer secret never enters the prompt or transcript, and the OAuth refresh flow is handled by Jentic without agent involvement.

Intent-based discovery

Agents search by intent (e.g. 'record a research insight') and Jentic returns the matching Glean.ly operation with its request schema, so the agent can call POST /api/insight or POST /api/conclusion without reading docs.

Time to first call

Direct Glean.ly integration: 1-2 days for OAuth client setup, token refresh, and request shaping. Through Jentic: under 1 hour — search, load, execute.

FAQs

Specific to using Glean.ly API through Jentic.

What authentication does the Glean.ly API use?

Glean.ly uses OAuth 2.0 with the authorisation server at oauth.glean.ly. Begin the flow at /authorizeRoute and exchange the code for a Bearer token. Through Jentic the issued token is held in the MAXsystem vault and the agent only ever sees a scoped execution credential.

Can I record an insight programmatically with the Glean.ly API?

Yes. POST /api/insight accepts a payload describing the observation and the linked source artefact ids. Pair it with POST /api/experiment and POST /api/experiment/{id}/fact to ingest a full chain of evidence under one experiment in a single agent run.

What are the rate limits for the Glean.ly API?

Glean.ly does not publish a numeric per-token rate limit; in practice the API is sized for human-pace research-ops use and bursts above a few requests per second on write endpoints may return HTTP 429. Back off briefly and retry, and prefer batching facts under one experiment.

How do I capture a conclusion through Jentic with Glean.ly?

Search Jentic for 'record a research conclusion', load POST /api/conclusion, and execute with the OAuth token from the vault. Pass the linked insight ids and a clear conclusion title so the audit trail back to the supporting research is preserved in the repository.

Does the Glean.ly API expose the themes and labels taxonomy?

Yes. GET /api/themes returns every theme defined in the repository, GET /api/labels returns the labels, and the matching POST endpoints let an agent add to the taxonomy when a new piece of research introduces a category. Use these endpoints to keep tagging consistent at scale.

Is the Glean.ly API free?

API access is included in the standard Glean.ly research-repository plans rather than billed separately. Pricing tiers depend on workspace seat count and storage; consult the Glean.ly sales site for the current plan that fits your team size and research volume.

Glean.ly API

Connect the Glean.ly API to your agent

Capabilities

Start building with Glean.ly API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs