Draft Response
draft_responseUse this to draft a reply to a scored pitch: an interested reply, a request for salary and remote details, or a polite decline. It needs an evaluation_id from score_message or get_scoreboard; evaluations expire after 30 days. Errors: unknown_evaluation means score the pitch again with score_message and use the new evaluation_id; no_desk means call set_criteria first. Decision defaults to the recommended action. For a decline, ask the user whether to include the feedback card. Returns subject and body as a draft only; it never sends anything, and the user sends the reply themselves. The desk is the signed-in user's, so send no desk_key.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"evaluation_id": "ev_3c92680b"
},
"name": "draft_response"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| decision | No | Kind of reply. Defaults to the evaluation's recommended_action. | |
| evaluation_id | Yes | The evaluation_id returned by score_message or get_scoreboard, such as "ev_3f9a1c2b". Evaluations expire after 30 days. | |
| include_feedback | No | Only for decline: true appends a 3-line feedback card that says why the pitch did not fit. Defaults to false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Draft reply body, with the feedback card appended when asked for. | |
| as_of | Yes | Day of the call, as YYYY-MM-DD in UTC. | |
| notes | Yes | Reminder that this is a draft and nothing is sent. | |
| source | Yes | Where the data comes from: the user's own private desk. | |
| subject | Yes | Draft subject line. | |
| decision | Yes | Kind of reply drafted. | |
| evaluation_id | Yes | The evaluation the reply is for. | |
| feedback_card | Yes | The feedback card text, or null when not asked for or not a decline. | |
| sender_domain | Yes | Sender domain of the pitch. |