Developer · API reference

Prompts

Manage the tracked prompts LunaLift runs against AI-search providers.

Prompts are the AI-search queries LunaLift runs on a schedule to measure your visibility and sentiment. These endpoints list your tracked prompts, create and generate new ones, run them on demand, and configure which providers each is tracked against.

GET /prompts/get-prompts/{company_id}

Get Prompts

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Query parameters

Name	Type	Required	Default	Description
`skip`	integer	No	0	Number of prompts to skip
`limit`	integer	No	50	Maximum number of prompts to return
`search`	string \| null	No	—	Search in prompt text
`status`	string \| null	No	—	Filter by status: pending (Topic Explorer), reviewed (Tracked Prompts), failed
`is_active`	boolean \| null	No	—	Filter by active/paused status
`segment_ids`	string \| null	No	—	Comma-separated segment IDs to filter by (includes special 'none' UUID)
`offering_ids`	string \| null	No	—	Comma-separated offering IDs to filter by (includes special 'none' UUID)
`location_ids`	string \| null	No	—	Comma-separated location IDs to filter by (includes special 'none' UUID)
`value_proposition_ids`	string \| null	No	—	Comma-separated value proposition IDs to filter by (includes special 'none' UUID)
`buying_stage_ids`	string \| null	No	—	Comma-separated buying stage IDs to filter by (includes special 'none' UUID)
`ideal_customer_ids`	string \| null	No	—	Comma-separated ideal customer IDs to filter by (includes special 'none' UUID)
`topic_ids`	string \| null	No	—	Comma-separated topic IDs to filter by (includes special 'none' UUID)
`visibility`	boolean \| null	No	—	Filter by visibility tracking
`sentiment`	boolean \| null	No	—	Filter by sentiment tracking
`source`	PromptSource[] \| null	No	—	Filter by prompt provenance (e.g. google_search_console). Repeat or comma-separate for multiple.
`sort_by`	string	No	created_at	Sort by: created_at, last_executed_at, visibility, visibility_change, sentiment, sentiment_change
`sort_order`	string	No	desc	Sort order: asc or desc

Example request

curl -X GET "https://api.lunalift.ai/prompts/get-prompts/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`conversationId`	string \| null	—
`data`	PromptCollection[] \| null	—
`total`	integer \| null	—
`metrics`	object \| null	—
`hasTracked`	boolean \| null	—

POST /prompts/create-prompt/{company_id}

Create Prompt

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Request body· Body_create_prompt_prompts_create_prompt__company_id__post

Field	Type	Required	Description
`prompt`	Prompt	Yes	Generated prompts with cached text and metadata.
`prompt_references`	PromptReference[]	Yes	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/create-prompt/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": {},
  "prompt_references": []
}'

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`conversationId`	string \| null	—
`data`	PromptCollection[] \| null	—
`total`	integer \| null	—
`metrics`	object \| null	—
`hasTracked`	boolean \| null	—

POST /prompts/generate-prompts/{company_id}

Generate Prompts

Generate prompts for a company collection

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/generate-prompts/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

POST /prompts/execute-prompts/{company_id}

Execute Prompts

Execute specific prompts on-demand

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/execute-prompts/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

GET /prompts/responses/{prompt_id}

Get Prompt Responses

Get the last N successful responses for a prompt, optionally filtered by provider

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`prompt_id`	string	Yes	—

Query parameters

Name	Type	Required	Default	Description
`provider`	LlmProvider \| null	No	—	—
`limit`	integer	No	5	—

Example request

curl -X GET "https://api.lunalift.ai/prompts/responses/PROMPT_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`conversationId`	string \| null	—
`data`	object \| null	—

POST /prompts/update-setting/{prompt_id}

Update Prompt Setting

Update a specific setting for a prompt

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`prompt_id`	string	Yes	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/update-setting/PROMPT_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

POST /prompts/toggle-provider/{prompt_id}

Toggle Prompt Provider

Enable or disable a specific LLM provider for a prompt

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`prompt_id`	string	Yes	—

Query parameters

Name	Type	Required	Default	Description
`provider`	LlmProvider	Yes	—	—
`enable`	boolean	Yes	—	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/toggle-provider/PROMPT_ID?provider=VALUE&enable=VALUE" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

POST /prompts/bulk-update/{company_id}

Bulk Update Prompts

Bulk update multiple prompts at once

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Request body· BulkPromptUpdate

Field	Type	Required	Description
`prompt_ids`	string[] \| null	No	—
`use_filters`	boolean \| null	No	—
`search`	string \| null	No	—
`is_active`	boolean \| null	No	—
`segment_ids`	string[] \| null	No	—
`offering_ids`	string[] \| null	No	—
`location_ids`	string[] \| null	No	—
`value_proposition_ids`	string[] \| null	No	—
`buying_stage_ids`	string[] \| null	No	—
`ideal_customer_ids`	string[] \| null	No	—
`visibility`	boolean \| null	No	—
`sentiment`	boolean \| null	No	—
`action`	string	Yes	—
`value`	integer \| null	No	—
`search_term`	string \| null	No	—
`replace_term`	string \| null	No	—
`case_sensitive`	boolean \| null	No	—
`enable_providers`	string[] \| null	No	—
`disable_providers`	string[] \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/bulk-update/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "string"
}'

Response · 200 OK

Returns a JSON object on success.

GET /prompts/providers/{company_id}

Get Company Providers

Get standard LLM providers for a company based on their plan

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X GET "https://api.lunalift.ai/prompts/providers/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`providers`	LlmProvider[]	—

GET /prompts/topics/{company_id}

Get Topics

Get all active topics for a company.

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—

Example request

curl -X GET "https://api.lunalift.ai/prompts/topics/COMPANY_ID" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Returns a JSON object on success.

POST /prompts/topics/{company_id}/{topic_id}/deactivate

Deactivate Topic Endpoint

Soft-remove a tracked topic (``is_active = false``), freeing its slot. Because the tracked-topic cap is now enforced on a LIVE ``COUNT(is_active AND status='confirmed')`` (see ``topics_confirmation``), the cap would be a one-way ratchet without a remove path. This is that path: it reuses the shared ``topics_confirmation.deactivate_topic`` soft-remove (the same ``is_active`` flip ``propose_topics`` uses for stale suggestions) so there is ONE deactivation mechanism, not a parallel one. Tenant-scoped: the company is resolved from the path and authorized against the caller's memberships; the ``company_id`` predicate is also part of the UPDATE so a topic can never be flipped cross-tenant. Idempotent — deactivating an already-inactive topic returns ``deactivated=false`` with the unchanged count.

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Path parameters

Name	Type	Required	Description
`company_id`	string	Yes	—
`topic_id`	integer	Yes	—

Example request

curl -X POST "https://api.lunalift.ai/prompts/topics/COMPANY_ID/TOPIC_ID/deactivate" \
  -H "Authorization: Bearer ll_your_api_key"

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`deactivated`	boolean	—
`topics_used`	integer	—