Skip to main content
PATCH
Update golden set row

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Path Parameters

sid
string
required

Golden set row sid (ub_eg_…).

Required string length: 18
Pattern: ^ub_eg_

Body

application/json

Request body of update_agent_example.

keep
boolean

true on a proposed edit (From your edits): it joins the set as golden.

tier
enum<string>

golden promotes (and keeps a proposed row), auto demotes.

Available options:
golden,
auto
note
string | null

When the row applies, max 512 chars; null clears it.

Maximum string length: 512
situation
string

The situation, rewritten: the thread's names are stored as placeholders again, and the row is embedded again.

Required string length: 1 - 4000
context_before
string | null

Our message before it; the row is embedded again.

Maximum string length: 1500
answer
string

The answer, rewritten: a name of the thread's lead, their company or the sender profile is stored as its placeholder again.

Required string length: 1 - 8000
scenario_key
string | null

The scenario it belongs to.

Maximum string length: 64
channel
enum<string> | null

The channel it answers on; null for every channel.

Available options:
linkedin,
email

Response

update success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
update
item
object
required
updated_fields
string[]
required
previous_values
object
required
meta
object
required
kept_fields
string[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.