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

Get prompt insights GET

Visibility, share of voice and position per tracked brand for one prompt.

Tag prompts POST

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

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Prompts

Bulk update prompts

POST
/brands/{brandId}/prompts/bulk

Change the type, intent, location or enabled state of prompts, or delete them.

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

Request Body

application/json
  1. body
  1. body
  2. …
ids*array<>
Items1 <= items <= 100
action*string
Value in"classify""locate""delete""enable""disable"
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?|

For locate: a country code, or null for Global

Match^[a-z]{2}$

Response Body

Applied to every listed prompt of the brand

application/json
  1. response
  1. response
  2. …
updated*integer
skipped*integer

Prompts left unchanged: same text already in that location, or already enabled or disabled

Example Request
curl -X POST 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/bulk' \  -H 'Content-Type: application/json' \  -d '{  "ids": [    "6e0346a3-e54d-40e3-9779-4ba1e707e35b"  ],  "action": "classify"}'
Example Response
{  "updated": 0,  "skipped": 0}

Get prompt insights GET

Visibility, share of voice and position per tracked brand for one prompt.

Tag prompts POST

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

Start free trial
Start free trial
Example Request
curl -X POST 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/bulk' \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "6e0346a3-e54d-40e3-9779-4ba1e707e35b"
  ],
  "action": "classify"
}'
{
  "updated": 0,
  "skipped": 0
}