Approve a task

curl --request POST \
  --url https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "opened": false
}
'

import requests

url = "https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/"

payload = { "opened": 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({opened: false})
};

fetch('https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/', 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/outreach-tasks/{task_id}/approve/",
  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([
    'opened' => 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/outreach-tasks/{task_id}/approve/"

	payload := strings.NewReader("{\n  \"opened\": 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/outreach-tasks/{task_id}/approve/")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"opened\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/")

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  \"opened\": false\n}"

response = http.request(request)
puts response.read_body

{
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by_display_name": "<string>",
  "ask_reason": "low_confidence",
  "body": "<string>",
  "channel": "linkedin",
  "confidence": "<string>",
  "confidence_score": 123,
  "contact_label": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "due_at": "2023-11-07T05:31:56Z",
  "editable": true,
  "enrolment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "flagged": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "<string>",
  "linkedin_action_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "note": "<string>",
  "outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "outcome": "<string>",
  "reasoning": "<string>",
  "record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rejected_at": "2023-11-07T05:31:56Z",
  "rejected_by_display_name": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "saved_learnings": 123,
  "saved_learnings_for_all_sequences": 123,
  "sender_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sender_profile_name": "<string>",
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sequence_name": "<string>",
  "status": "pending",
  "step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "step_name": "<string>",
  "step_position": 123,
  "subject": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "words_edited": true,
  "contact_company": "<string>",
  "contact_fields": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "contact_identity": "<string>",
  "contact_title": "<string>",
  "progress": {
    "error_code": "<string>",
    "error_message": "<string>",
    "hold_reason": "window",
    "linkedin_queue": "running",
    "may_have_sent": true,
    "resets_at": "2023-11-07T05:31:56Z",
    "retryable": true,
    "starts_at": "2023-11-07T05:31:56Z",
    "state": "queued",
    "steps_ahead": 123,
    "hold": "sequence_paused",
    "pause_reason": "<string>"
  },
  "proposed_learning_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "proposed_learning_redo_state": "none",
  "reply_subject": "<string>",
  "schedule": {
    "email_count": 123,
    "email_starts_at": "2023-11-07T05:31:56Z",
    "linkedin": [
      {
        "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "after_reset": 123,
        "before_reset": 123,
        "blocked": "browser_offline",
        "count": 123,
        "first_at": "2023-11-07T05:31:56Z",
        "last_at_estimate": "2023-11-07T05:31:56Z",
        "resets_at": "2023-11-07T05:31:56Z",
        "sender_name": "<string>",
        "sender_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "held": 0,
        "opens_at": "2023-11-07T05:31:56Z",
        "outside_window": 0
      }
    ],
    "email_held": 0
  },
  "sender_browser_online": true,
  "sequence_paused": false
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>",
  "issues": [
    {
      "input": "<string>",
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

outreach

Approve a task

Let a pending task run, and record who said so. An approved LinkedIn step joins its sender’s line, and whichever browser holds the lease performs it in turn: a reply at once, a sequence’s step through the send engine, which holds it while its sequence or contact is paused. An approved email is sent at once, or when its sequence’s sending window opens. The answer is the task’s row plus schedule, the same forecast the bulk approve gives: when the step is expected to run and what would stop it. 409 when the task is no longer pending, or when its step cannot be taken now (the sender’s LinkedIn is not connected, the connection request it would withdraw is no longer pending, the send engine could not take a sequence’s step just now); the task then still waits. When the person opened the task first (opened), words the agent wrote that nobody changed are recorded as approved as written: their Looks good, kept as a record. A person’s approval saves the learning a Needs work on the card proposed (proposed_learning_event_id), and is refused with 409 while that Needs work’s rewrite is still being written. The learning is left unsaved when its list is full while the approval stands: saved_learnings says whether it was saved.

POST

outreach-tasks

{task_id}

approve

Approve a task

curl --request POST \
  --url https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "opened": false
}
'

import requests

url = "https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/"

payload = { "opened": 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({opened: false})
};

fetch('https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/', 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/outreach-tasks/{task_id}/approve/",
  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([
    'opened' => 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/outreach-tasks/{task_id}/approve/"

	payload := strings.NewReader("{\n  \"opened\": 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/outreach-tasks/{task_id}/approve/")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"opened\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getoneprofile.ai/outreach-tasks/{task_id}/approve/")

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  \"opened\": false\n}"

response = http.request(request)
puts response.read_body

{
  "approved_at": "2023-11-07T05:31:56Z",
  "approved_by_display_name": "<string>",
  "ask_reason": "low_confidence",
  "body": "<string>",
  "channel": "linkedin",
  "confidence": "<string>",
  "confidence_score": 123,
  "contact_label": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "due_at": "2023-11-07T05:31:56Z",
  "editable": true,
  "enrolment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "flagged": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "<string>",
  "linkedin_action_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "note": "<string>",
  "outbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "outcome": "<string>",
  "reasoning": "<string>",
  "record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rejected_at": "2023-11-07T05:31:56Z",
  "rejected_by_display_name": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "saved_learnings": 123,
  "saved_learnings_for_all_sequences": 123,
  "sender_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sender_profile_name": "<string>",
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sequence_name": "<string>",
  "status": "pending",
  "step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "step_name": "<string>",
  "step_position": 123,
  "subject": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "words_edited": true,
  "contact_company": "<string>",
  "contact_fields": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "contact_identity": "<string>",
  "contact_title": "<string>",
  "progress": {
    "error_code": "<string>",
    "error_message": "<string>",
    "hold_reason": "window",
    "linkedin_queue": "running",
    "may_have_sent": true,
    "resets_at": "2023-11-07T05:31:56Z",
    "retryable": true,
    "starts_at": "2023-11-07T05:31:56Z",
    "state": "queued",
    "steps_ahead": 123,
    "hold": "sequence_paused",
    "pause_reason": "<string>"
  },
  "proposed_learning_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "proposed_learning_redo_state": "none",
  "reply_subject": "<string>",
  "schedule": {
    "email_count": 123,
    "email_starts_at": "2023-11-07T05:31:56Z",
    "linkedin": [
      {
        "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "after_reset": 123,
        "before_reset": 123,
        "blocked": "browser_offline",
        "count": 123,
        "first_at": "2023-11-07T05:31:56Z",
        "last_at_estimate": "2023-11-07T05:31:56Z",
        "resets_at": "2023-11-07T05:31:56Z",
        "sender_name": "<string>",
        "sender_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "held": 0,
        "opens_at": "2023-11-07T05:31:56Z",
        "outside_window": 0
      }
    ],
    "email_held": 0
  },
  "sender_browser_online": true,
  "sequence_paused": false
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>",
  "issues": [
    {
      "input": "<string>",
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

task_id

string<uuid>

required

Query Parameters

dry_run

boolean

default:false

Answer what the decision would do, exactly as the real call answers it, and change nothing.

Body

application/json

Whether the person read the task before approving it.

opened

boolean

default:false

The person opened the task and read its message before approving. Words the agent wrote that they approved without changing are then recorded as approved as written: a record of their Looks good, which saves no learning.

Response

Successful Response

One approved task's row, and when the work it let go is expected to run.

approved_at

string<date-time> | null

required

approved_by_display_name

string | null

required

Who approved it, as a name. Null when nobody has, or the person could not be resolved.

ask_reason

enum<string> | null

required

Why this message or step is waiting for a person instead of running on its own. It stays on the task after it is decided, so the history still says why it was asked. Null when no reason was recorded.

About the message: low_confidence the agent did not rate it high; insufficient_data the agent knew too little about the contact to write something only they could receive. Only older tasks carry findings (a check found a problem in it, such as a placeholder that never filled in) or policy (it broke one of the agent's content rules): checks no longer hold a message.

About the settings: always_ask the sender has a person approve every email, or every LinkedIn step; sequence_manual the sequence asks for approval of every email or LinkedIn step; step_requires_approval this step asks for approval; sender_switched_to_manual the LinkedIn step was on its way unattended when its sender switched to asking first, so it waits for a person again.

About sending limits: daily_cap the mailbox has reached its daily limit; consecutive_cap the agent sent the last reply and nobody has written since; thread_cap the conversation has had as many unattended replies as it may; hourly_cap the mailbox has reached its hourly reply limit; org_daily_cap the workspace has reached its daily reply limit.

About the conversation: stale_inbound a newer message arrived, or the one being answered is too old; unverified_sender the reply could not be confirmed as coming from the contact; different_sender someone other than the contact wrote it; authentication it failed email authentication or was marked as spam; label the reply is not one the agent answers on its own; suppressed the contact is on the do-not-contact list; sequence_gone the sequence or the agent's message no longer exists; linkedin_only the contact is known only by LinkedIn, so no unsubscribe could be honoured.

About the other side: bot_question the contact asked whether they are talking to a bot or an AI; question the contact asked something a person should answer; automated_counterparty the other side appears to be an automated system; language the message is not in the expected language.

kill_switch unattended sending is paused for the workspace or the platform.

Available options:

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

body

string | null

required

The rendered message as it will send: an email body, a note, a LinkedIn message.

channel

enum<string>

required

Which channel performs the task once it is allowed to run.

Available options:

linkedin,

email

confidence

string | null

required

How sure the agent was that its message could go out unedited: high (a person could send it unread), medium (worth a glance) or low (needs work). Null when no agent wrote the message.

confidence_score

integer | null

required

The number behind confidence: the agent's own score for its message, from 0 to 100. Read from the agent's message as it stands now. Null when no agent wrote the message, or the agent gave no score.

contact_label

string | null

required

The contact as the queue names them: a name, else an address or a profile URL.

created_at

string<date-time>

required

due_at

string<date-time>

required

When the channel would run it if nobody were in the way.

editable

boolean

required

Whether the queue may rewrite the message before approving: pending, and a kind that carries text.

enrolment_id

string<uuid> | null

required

flagged

boolean

required

Whether a check found a problem in the agent's message (any finding at warning strength), whatever ask_reason says: a task held for a setting can still carry a message with a placeholder that never filled in. False when no agent wrote the message.

string<uuid>

required

kind

string

required

The LinkedIn action kind slug or email.

linkedin_action_id

string<uuid> | null

required

note

string | null

required

What the person wrote when settling it: why they rejected it.

outbound_message_id

string<uuid> | null

required

The message the Outbound Agent wrote for this task. Null when a person wrote the words, and on a LinkedIn step that carries no message.

outcome

string | null

required

How it ended: the channel's own terminal word.

reasoning

string | null

required

The agent's reason for its confidence, given after it wrote the message: what the message rests on and what it was unsure about. Null when no agent wrote the message.

record_id

string<uuid> | null

required

rejected_at

string<date-time> | null

required

rejected_by_display_name

string | null

required

resolved_at

string<date-time> | null

required

saved_learnings

integer

required

How many learnings the task's Needs work proposed this approval saved: 1 or 0. A proposed learning whose list is full is left unsaved while the approval stands, so a card that proposed one and answers 0 saved nothing. On a dry run, how many approving it would save.

saved_learnings_for_all_sequences

integer

required

Of saved_learnings, how many apply to every sequence, not only their own.

sender_profile_id

string<uuid> | null

required

sender_profile_name

string | null

required

Null when nobody in particular sends it, or the sender was deleted.

sequence_id

string<uuid> | null

required

sequence_name

string | null

required

Null for housekeeping work, or for a sequence since deleted.

status

enum<string>

required

Where one task stands.

PENDING is waiting on a person. SCHEDULED is approved, or never needed approval, and is waiting on the channel to execute it: the browser to run the LinkedIn step, the engine to send the email. The task is where a LinkedIn step's approval lives: while it is PENDING no step exists, and the step is queued only once it is SCHEDULED. A LinkedIn task nobody is asked about (a sender on automatic, a housekeeping read, a Try click) is BORN scheduled, pointing at the step it queued. Who approved it is a stamp on the row, not a status of its own.

DONE, REJECTED and CANCELLED are terminal. DONE is the channel executed it; REJECTED is a person refused it; CANCELLED is the channel gave up on it (failed, skipped, expired), or the contact was stopped underneath it.

Available options:

pending,

scheduled,

done,

rejected,

cancelled

step_id

string<uuid> | null

required

step_name

string | null

required

The step as the builder names it; null when the step no longer exists.

step_position

integer | null

required

The step's customer-visible ordinal, zero-based; null with the name.

subject

string | null

required

updated_at

string<date-time>

required

words_edited

boolean

required

Whether a person changed the words the card shows (an edit saved before approving). Needs work is refused on such a card: the agent can't learn from a person's words. False again once the agent writes the card's words anew.

contact_company

string | null

The contact's company, from whichever column of the audience table holds it ('Company', 'Company Name', 'Organization' and the like). Null when the table has none or leaves it blank.

contact_fields

OutreachTaskContactFieldSchema · object[]

Every filled column of the contact's audience row, in the table's order. Empty for housekeeping work and for a row since deleted.

Show child attributes

contact_identity

string | null

The address, profile slug or number behind the label, so a row can show the name and still say who that is. Equal to the label where no name was found; null for housekeeping.

contact_title

string | null

The contact's job title, from whichever column of the audience table holds it ('Job Title', 'Title', 'Position' and the like). Null when the table has none or leaves it blank.

progress

OutreachTaskProgressReadSchema · object | null

Where the work stands once the queue has let it go, read from the channel: set on approved, finished and cancelled tasks, null on a task still waiting on a person and on one a person rejected.

Show child attributes

proposed_learning_event_id

string<uuid> | null

The Needs work on this card whose learning waits to be saved (Will learn): a person's approval saves it. Read it with GET /agent-learnings/thumbs-downs/ (subject_key task:<id>). Null when none waits.

proposed_learning_redo_state

enum<string> | null

How the rewrite that waiting learning asked for stands: started while the card is written again, written once its new words are in, refused when the rewrite didn't go through (or never started), so the learning waits for Retry or Discard and approving the card saves nothing with it. Null when no learning waits.

Available options:

none,

started,

written,

refused

reply_subject

string | null

For an email that replies in the contact's existing thread, the subject it will go out with, such as 'Re: Quick question'. Null for a first email, which carries its own subject, and for anything that is not an email.

schedule

OutreachApprovalScheduleReadSchema · object | null

When the approved step is expected to run, as the bulk approve reports it. Null when the task had moved on instead of being approved, or when the schedule could not be read (the approval stands either way).

Show child attributes

sender_browser_online

boolean | null

For a LinkedIn task still waiting on a person: whether a browser is checked in for its sender right now, so approving it would run it soon. False means an approved step waits until a browser is open. Null for every other task.

sequence_paused

boolean

default:false

Its sequence is paused right now: approving the task records the approval, and the step waits for Resume sequence before it runs, on either channel.

API reference

Endpoints

Approve a task

Authorizations

Path Parameters

Query Parameters

Body

Response