Skip to main content
GET
Get one AI Visibility prompt

Authorizations

Authorization
string
header
required

An agent key (rpk_...) created in Settings → API & MCP, sent as Authorization: Bearer rpk_.... Bearer only: a cookie session can never drive this API. An OAuth 2.1 access token obtained from the same host works identically and lands on the same ceiling.

Headers

X-Workspace-Id
string

Which workspace to read. Omit it and you get the account’s home workspace, which on an agency account is often not where the live businesses are. A workspace this credential cannot read is refused with 403 rather than quietly answered from the default.

Path Parameters

id
string
required

The AI Visibility prompt id.

Response

The AI Visibility prompt.

id
string

Unique id.

tracker_id
string
location_id
string

Denormalized from the tracker for fast per-business usage counting.

text
string
tag
string

Optional single tag (persona / funnel stage). Multi-tag segmentation is deferred to v2.

variations
string[]

LLM-generated alternative phrasings of text (same intent, different wording — peec.ai style). Each run cycle asks the original plus every variation, so the visibility score samples how customers actually ask instead of one lucky wording. Generated once by runVisibilityTracker on the first run after the prompt is created; empty/absent = track the original only.

variations_generated_at
string
is_active
boolean