Skip to main content
POST
Regenerate message draft

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

The draft to rewrite. It must be pending_approval AND carry an agent_run_sid, else 409 message_not_editable.

Required string length: 18
Pattern: ^ub_ms_

Body

application/json

Request body of regenerate_message.

guidance
string | null

Steering for the next attempt, max 1024 ("shorter, mention the SOC 2 report"). It rides the run together with the discarded draft, so the new text is materially different.

Maximum string length: 1024

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
object | null
required
result
object
required
meta
object
required