Skip to main content
POST
Add to the golden set

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.

Body

application/json

Request body of create_agent_example.

agent_sid
string

The AI SDR it is made for (ub_ag_…, block 10, 2026-10-30); left out, the team's default agent.

Required string length: 18
Pattern: ^ub_ag_
message_sid
string

Remember this reply: a message of ours that went out (ub_ms_…) becomes a golden row, the lead's message before it the situation; promoted when held already. 409 message_not_sent, message_has_no_situation. Takes note, not the fields below.

Required string length: 18
Pattern: ^ub_ms_
situation
string

A pair typed by hand: what the lead wrote, 1..4000 chars, names as placeholders ({lead}, {lead_company}, {sender}). Required with answer.

Required string length: 1 - 4000
answer
string

The team's answer to it, 1..8000 chars. Required with situation.

Required string length: 1 - 8000
kind
enum<string>

reply (default) or followup.

Available options:
reply,
followup
context_before
string | null

Our message before the lead's, max 1500 chars.

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

The channel it answers on; omit for every channel.

Available options:
linkedin,
email
scenario_key
string | null

The scenario the situation belongs to (interested, objection, ...).

Maximum string length: 64
note
string | null

When the row applies, in a person's words, max 512 chars.

Maximum string length: 512

Response

create success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
create
item
object
required
already_exists
boolean
required
meta
object
required