GensivDocs
AcademyAPI referenceMCP

Basics

OverviewAuthenticationRate limitsErrors

Endpoints

List prompts GETAdd prompts POSTGet prompt insights GETBulk update prompts POSTTag prompts POSTSet prompt topics POSTUpdate prompt PATCH
Prompts

Set prompt topics POST

Add topics to or remove topics from several prompts, leaving their other topics.

List responses GET

List a brand's analysed responses, filtered, sorted and paged.

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Prompts

Update prompt

PATCH
/brands/{brandId}/prompts/{promptId}

Edit one prompt's text, type, intent, location, topics or tags.

Authorization

apiKey write
headerx-api-key<token>

Workspace API key from Settings > API keys. Also accepted as Authorization: Bearer gsk_...

Scope: write

Path Parameters

brandId*string
Formatuuid
promptId*string
Formatuuid

Request Body

application/json
  1. body
  1. body
  2. …
text?string
Length5 <= length <= 500
type?PromptType

organic: names no brand; brand_specific: names your brand; competitor_comparison: names a competitor

Value in"organic""brand_specific""competitor_comparison"
intent?PromptIntent

What the person asking wants to do

Value in"informational""commercial""navigational""branded"
countryCode?|

Country code, or null for Global

Match^[a-z]{2}$
topicIds?array<>
Itemsitems <= 50
tagIds?array<>
Itemsitems <= 50

Response Body

Prompt saved

Example Request
curl -X PATCH 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty

Set prompt topics POST

Add topics to or remove topics from several prompts, leaving their other topics.

List responses GET

List a brand's analysed responses, filtered, sorted and paged.

Start free trial
Start free trial
Example Request
curl -X PATCH 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'Content-Type: application/json' \
  -d '{}'