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": {}
}

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.