Skip to content
ansvra.Documentation
Prompts
Prompts

Update prompt

Update only supplied fields. Omitted values are preserved.

PATCH/projects/{projectId}/prompts/{id}
Required permission prompts:write

The key must include this project and its owner must still have access.

Authentication and permissions · Errors and limits

Authorization

Authorizationstring · headerRequired

Bearer access key. Never put a key in the URL.

Path parameters

projectIdstringRequired

Project identifier from List projects.

idstringRequired

Identifier from the corresponding resource list.

Request body

application/json. Unknown fields are rejected. Changes apply only to supplied fields; provide at least one field.

textstringOptional

Question text, 1–10,000 characters.

categoryIdstring | nullOptional

Category in this project. Creation without a category uses General.

followUpsstring[]Optional

Up to four questions, each 1–10,000 characters.

intentstringOptional

learn, compare, buy or find_brand.

brandedbooleanOptional

Whether this question names a brand.

activebooleanOptional

Whether the prompt is active. Existing enabled tracking can include active prompts.

archivedbooleanOptional

Archive or restore this prompt.

targetUrlstring | nullOptional

Public page on this project’s website, up to 2,000 characters. Null clears the target.

Response fields

dataobjectRequired

Update only supplied fields. Omitted values are preserved.

Child fields
idstringRequired

Unique identifier for this record.

projectIdstringRequired

Project that owns this record.

categoryIdstring | nullRequired

Saved category id.

textstringRequired

Saved text.

marketstringRequired

Saved market.

languagestringRequired

Saved language.

brandedbooleanRequired

Saved branded.

intentstringRequired

Saved intent.

followUpsJSONRequired

Follow-up questions in their saved order.

activebooleanRequired

Saved active.

archivedbooleanRequired

Saved archived.

targetUrlstring | nullRequired

Saved target url.

createdAtISO 8601 timestampRequired

When this record was saved, in UTC.

metaobjectRequired

Request metadata. Present on JSON success responses.

Child fields
requestIdstringRequired

Request identifier to include when contacting support.

resultScope"saved"Required

Saved customer information; excludes Overview preview results.

Ansvra

A clearer next step.

MEET YOUR AI GUIDE

A little clarity.
A clearer next move.

Ask about Ansvra, AI visibility, or your next step with content.

Opening chat…