curl --request POST \
--url https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"answers": [
{
"answer": "<string>",
"question_id": "<string>",
"question": "<string>",
"scope": "sequence"
}
],
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"also_answer_waiting": false
}
'import requests
url = "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/"
payload = {
"answers": [
{
"answer": "<string>",
"question_id": "<string>",
"question": "<string>",
"scope": "sequence"
}
],
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"also_answer_waiting": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
answers: [
{
answer: '<string>',
question_id: '<string>',
question: '<string>',
scope: 'sequence'
}
],
message_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
also_answer_waiting: false
})
};
fetch('https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'answers' => [
[
'answer' => '<string>',
'question_id' => '<string>',
'question' => '<string>',
'scope' => 'sequence'
]
],
'message_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'also_answer_waiting' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/"
payload := strings.NewReader("{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}"
response = http.request(request)
puts response.read_body{
"body_text": "<string>",
"confidence": "high",
"confidence_reason": "<string>",
"generated_body_text": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kept_for_this_conversation": [
"<string>"
],
"not_saved": [
{
"question_id": "<string>",
"reason": "names_contact"
}
],
"source": "auto_drafted",
"status": "pending_approval",
"steer_text": "<string>",
"subject": "<string>",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ask_reason": "low_confidence",
"channel": "email",
"confidence_score": 123,
"hand_edited": false,
"learning_subject_key": "<string>",
"mailbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"rating": "good",
"rewriting": false,
"send_after": "2023-11-07T05:31:56Z",
"send_outcome": "as_written",
"sent_by_kind": "person"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Answer the agent's questions on a reply
The Submit on a conversation’s “Before I draft a reply, I need to know” card (question_card). Give an answer to every question the card asks, each by its id; the sequence’s agent then writes the reply with those answers in front of it, charged as any reply it writes, and the reply waits for a person in Needs approval. The card closes once the reply is written. When nothing usable was written it answers 409 saying so, and the card stays open.
Each answer may reword its question (question) and says where it is kept (scope): sequence, the default, as on the card, in the Q&A for the reply’s sequence, which every later reply its agent writes reads; account in the Q&A for every sequence; this_reply for this conversation alone, so a later Rewrite and every later reply in it have it too (an answer sent with no scope was kept so until 2026-10-27). A saved answer goes into the Q&A once the reply is written, signed by the person, under its question as worded: a question its scope has already takes the new answer, and the card’s saved_answers offers it next time the question is asked.
A saved answer is kept for this conversation instead when its question or answer names the contact by email address or full name (names_contact), when its question is new and the Q&A is full (qa_full), or when it differs from the answer the Q&A holds in that scope and the caller is not a workspace admin (admin_only; a member may still give one sequence its own answer to a question held for every sequence). The reply is written either way; kept_for_this_conversation lists those questions and not_saved says why for each.
With also_answer_waiting, the agent also answers the other conversations of the sequence waiting on the same questions that the saved answers and the Q&A answer between them (the card’s others_waiting): each is written in the background as a reply of its own, charged as any reply the agent writes, and waits for approval.
One person’s answers write the reply: answers sent while another person’s are being written wait for them, then write nothing, and the 409 names who answered.
curl --request POST \
--url https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"answers": [
{
"answer": "<string>",
"question_id": "<string>",
"question": "<string>",
"scope": "sequence"
}
],
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"also_answer_waiting": false
}
'import requests
url = "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/"
payload = {
"answers": [
{
"answer": "<string>",
"question_id": "<string>",
"question": "<string>",
"scope": "sequence"
}
],
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"also_answer_waiting": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
answers: [
{
answer: '<string>',
question_id: '<string>',
question: '<string>',
scope: 'sequence'
}
],
message_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
also_answer_waiting: false
})
};
fetch('https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'answers' => [
[
'answer' => '<string>',
'question_id' => '<string>',
'question' => '<string>',
'scope' => 'sequence'
]
],
'message_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'also_answer_waiting' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/"
payload := strings.NewReader("{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/inbox/threads/{thread_id}/answers/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"answers\": [\n {\n \"answer\": \"<string>\",\n \"question_id\": \"<string>\",\n \"question\": \"<string>\",\n \"scope\": \"sequence\"\n }\n ],\n \"message_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"also_answer_waiting\": false\n}"
response = http.request(request)
puts response.read_body{
"body_text": "<string>",
"confidence": "high",
"confidence_reason": "<string>",
"generated_body_text": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kept_for_this_conversation": [
"<string>"
],
"not_saved": [
{
"question_id": "<string>",
"reason": "names_contact"
}
],
"source": "auto_drafted",
"status": "pending_approval",
"steer_text": "<string>",
"subject": "<string>",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ask_reason": "low_confidence",
"channel": "email",
"confidence_score": 123,
"hand_edited": false,
"learning_subject_key": "<string>",
"mailbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"rating": "good",
"rewriting": false,
"send_after": "2023-11-07T05:31:56Z",
"send_outcome": "as_written",
"sent_by_kind": "person"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Body
The answers to every question on a reply's card.
Also have the agent answer the other conversations of the sequence waiting on the same questions (the card's others_waiting), from the answers saved to the Q&A here and the Q&A's own. Each is a reply of its own, charged as any the agent writes and left for approval, written in the background.
Response
Successful Response
The reply written from a card's answers, and which answers stayed with it alone.
Where this reply stands. pending_approval: waiting for a person to approve, edit or discard it. scheduled: a reply an older release scheduled, which nothing sends now; it waits for a person exactly as pending_approval does, and is approved, edited or discarded the same way. sending: it is leaving now and can no longer be changed. send_unknown: it was sent, but the mailbox has not confirmed it yet; it settles on its own as sent or send_failed. send_failed: it did not go; write a fresh reply. sent: it went out. discarded: a person rejected it or asked for a new version. stale: the contact wrote again before anyone answered it.
pending_approval, sent, discarded, stale, scheduled, sending, send_unknown, send_failed Why an older release held this reply for a person when it would otherwise have sent it, for example low_confidence, always_ask, unverified_sender, different_sender or daily_cap. Every reply waits for a person now, so it is null on every reply written since, and on a reply a person asked for.
low_confidence, findings, insufficient_data, policy, always_ask, sequence_manual, step_requires_approval, daily_cap, unverified_sender, suppressed, different_sender, label, question, consecutive_cap, thread_cap, hourly_cap, org_daily_cap, stale_inbound, sequence_gone, bot_question, automated_counterparty, kill_switch, authentication, language, linkedin_only, send_interrupted, sender_switched_to_manual The channel the reply goes out on: the one the message it answers came in on, so a contact who answered a LinkedIn conversation by email is answered by email. Null on a reply written before this was recorded, which goes out on the conversation's own channel.
email, linkedin What a Needs work on this reply is filed under: list its events with GET /agent-learnings/thumbs-downs/?subject_key=. One key for every version of the reply (a Rewrite with no note, a Needs work's rewrite, its Undo), so the note a Needs work left on one version is found on the next. Null on a reply no sequence's agent wrote, which has no agent to save a learning for.
The agent's message this reply came from, when a sequence's agent wrote it. Ratings and the send are recorded against that message too. A rating saves no learning; a person's edit of the draft proposes one, which sending saves, and Needs work on the draft teaches too. Null only on a reply an older release wrote for a conversation outside any sequence.
True while a changed learning has the agent write this waiting reply again. Its words stay as they are, and can still be approved, edited or rejected, until the new words replace them; a reply a person approved, edited or sent meanwhile keeps the person's version. False on every other reply.
How the words a person sent stand to what the AI wrote, decided as they sent it. as_written: the AI's words, unchanged. edited: the person changed them and kept what they say. replaced: the person sent a reply of their own in its place. Null until a person sends it, on a reply an older release sent without one, and on one sent before this was recorded.
as_written, edited, replaced Was this page helpful?