Skip to main content
POST
/
api
/
v2
/
keywords
/
suggestions
Accept a keyword suggestion
curl --request POST \
  --url https://app.octolens.com/api/v2/keywords/suggestions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "suggestionId": 0,
  "modifiedValue": "<string>"
}
'
{
  "success": true,
  "appliedChanges": {}
}

Documentation Index

Fetch the complete documentation index at: https://octolens.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.

Body

application/json

Apply a suggestion to the keyword's config.

suggestionId
integer
required

Suggestion id to accept.

Required range: -9007199254740991 <= x <= 9007199254740991
modifiedValue
string

Override the suggested value before applying it — useful when the user wants to accept the direction but tweak the exact text.

Response

200 response

success
boolean
required
appliedChanges
object
required

Map of keyword fields that were changed to their new values (e.g. { "excludeWords": "spam,scam" }). Shape depends on the suggestion type.