Skip to content

Document the ElevenLabs, New Relic, Retool and Twingate sources - #108

Merged
aureliensibiril merged 1 commit into
v2from
access-review-elevenlabs-newrelic-retool-twingate
Sep 11, 2026
Merged

Document the ElevenLabs, New Relic, Retool and Twingate sources#108
aureliensibiril merged 1 commit into
v2from
access-review-elevenlabs-newrelic-retool-twingate

Conversation

@aureliensibiril

Copy link
Copy Markdown
Contributor

Docs for the four access-review connectors in getprobo/probo#1884.

Merge these together. The connectors set DocumentationURL, so the four
links in the Add Source dialog 404 until this deploys.

Pages

elevenlabs, new-relic, retool, twingate, plus a <LinkCard> each in
directory.mdx.

Every Collected Fields table is derived from the driver rather than the
vendor's docs, so a row marked Not supported is one the driver genuinely leaves
empty, and a row naming a provider field is one it actually reads.

Facts a reader hits, recorded because we hit them

  • ElevenLabs refuses a bad key with 400 where most APIs answer 401.
  • New Relic runs three regional endpoints (us, eu, jp) and refuses a
    key presented to the wrong one, so the page tells the reader that a connection
    refused after the key is accepted is usually the region. Listing users needs a
    Core or Full platform account and the Authentication Domain Manager role,
    not just the role.
  • Twingate fails the connection outright on a network name that does not
    exist, rather than returning an empty campaign.
  • Retool is Enterprise-gated. users:read is absent from the token dialog
    on Team and on Business, and a Business token holding every scope it can grant
    is still refused. Retool's pricing page reserves "full access to all API
    scopes" for Enterprise. The page says so and points a customer without it at a
    CSV source.

Review

Written from the connector code, then run through a humanizer pass, a
structure and credential audit, an accuracy judge that re-derived every table
row from the drivers, and an adversarial Codex pass. The last two caught the
New Relic account-type requirement, the jp region, Twingate's seven roles,
and that ElevenLabs keys are editable and can carry an expiry that would
silently kill a connector.

npm run build passes; no em or en dashes; no credentials or account
identifiers in the text.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JFFcusrDZo9AR42g5Te2wS

@aureliensibiril
aureliensibiril force-pushed the access-review-elevenlabs-newrelic-retool-twingate branch 2 times, most recently from 292185e to aa2f2ec Compare September 11, 2026 17:59
@aureliensibiril

Copy link
Copy Markdown
Contributor Author

check was red for a reason unrelated to this PR

docs:check-reference regenerates environment-reference.mdx from a fresh checkout of getprobo/probo and fails if the committed file differs. The committed file was 736 lines behind probo main, and none of that drift comes from this branch (it touches nothing under docs/deployment/). The same failure already hit v2 directly when the Crisp guide landed, and since deploy.yaml runs the identical check, the site deploy was blocked too.

Added 0dd38ac to regenerate it. Split of the diff:

Source Lines
Pre-existing drift vs probo main 736
Added by getprobo/probo#1884 (4 connectors x 5 PROBOD_CONNECTOR_*_ENDPOINT_*) 20

I generated against the probo#1884 branch, not plain main, so the file matches the state that exists after both PRs land. The consequence is that check here stays red until #1884 is on main — by construction.

Merge order matters: getprobo/probo#1884 first, then this one. The reverse order leaves the v2 deploy failing on the twenty connector rows, and the DocumentationURL links added here 404 until the console change ships.

npm run build passes locally (455 pages).

@aureliensibiril
aureliensibiril force-pushed the access-review-elevenlabs-newrelic-retool-twingate branch from 0dd38ac to 72f2763 Compare September 11, 2026 19:13
@aureliensibiril

Copy link
Copy Markdown
Contributor Author

Traced the root cause. Regenerating the page at the parent of probo commit b995080d3 ("Connect Crisp by app install, not a pasted code") reproduces the file currently committed on v2 byte for byte, so that one commit is the entire cause.

It added no variable. It shifted pkg/bootstrap/builder.go by two lines, and every row here carries a builder.go#Lnnn "View usage" deep link, so ~368 rows went stale at once. That is also why the Crisp env vars (PROBOD_CONNECTOR_CRISP_PLUGIN_ID / _PLUGIN_TOKEN) look correct on v2 today: they are.

Worth noting the blast radius is already on trunk. The v2 deploy failed at this same check before the astro build, so the Crisp guide rewrite never reached the live site; production is still serving the "Optimize assets" build from 15:33.

Structural, not a one-off: any edit to builder.go invalidates these links and breaks the docs deploy, with nothing in the probo repo to warn you.

Four API-key access-review sources, each with the page structure the
other connector guides use, plus their directory entries.

Retool's users:read scope is Enterprise only. It is absent on Team and on
Business, where a token with every scope selected still gets 403, and no
other endpoint returns the roster, so the guide says so rather than
letting a customer buy Business and find out.

Also regenerates the environment reference: the provider registry emits
five PROBOD_CONNECTOR_<PROVIDER>_ENDPOINT_* variables per connector, so
these four add twenty rows even though none of them needs bootstrap
configuration. docs:check-reference compares that file against probo's
default branch, so this goes green once getprobo/probo#1884 is on main,
which is also when the DocumentationURL links here stop pointing at 404s.

Signed-off-by: Aurélien Sibiril <81782+aureliensibiril@users.noreply.github.com>
@aureliensibiril
aureliensibiril force-pushed the access-review-elevenlabs-newrelic-retool-twingate branch from 72f2763 to a08ea89 Compare September 11, 2026 19:18
@aureliensibiril
aureliensibiril merged commit a08ea89 into v2 Sep 11, 2026
1 of 2 checks passed
@aureliensibiril
aureliensibiril deleted the access-review-elevenlabs-newrelic-retool-twingate branch September 11, 2026 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant