Update an outreach target

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  -H "Content-Type: application/json" \
  -d '{"status":"contacted","note":"Emailed the editor on Oct 2.","tags":["gear-review"]}' \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/outreach/TARGET_ID"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/outreach/TARGET_ID", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…", "Content-Type": "application/json" },
  body: JSON.stringify({
    "status": "contacted",
    "note": "Emailed the editor on Oct 2.",
    "tags": [
      "gear-review"
    ]
  }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.post(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/outreach/TARGET_ID",
    headers={"Authorization": "Bearer mr_ws_…"},
    json={
        "status": "contacted",
        "note": "Emailed the editor on Oct 2.",
        "tags": [
            "gear-review",
        ],
    },
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/outreach/TARGET_ID");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"status":"contacted","note":"Emailed the editor on Oct 2.","tags":["gear-review"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.post(
  "https://app.monoranks.com/api/v1/sites/SITE_ID/outreach/TARGET_ID",
  {
    "status": "contacted",
    "note": "Emailed the editor on Oct 2.",
    "tags": [
      "gear-review"
    ]
  },
  { headers: { Authorization: "Bearer mr_ws_…" } },
);

{
  "target": {
    "id": "0b2d4f6a-8c0e-4a2c-9e4a-8c0e2a4c6e8a",
    "source": "link_gap",
    "url": "https://rideguide.example/best-bike-shops/",
    "domain": "rideguide.example",
    "title": "The best online bike shops",
    "score": 82,
    "class": "editorial",
    "reason": {
      "competitors": [
        "bikeworld.example",
        "cyclehub.example"
      ],
      "domainRank": 47,
      "ourRank": 33,
      "spamScore": 4,
      "outOf": 2,
      "backlinks": 5,
      "pages": [
        {
          "competitor": "bikeworld.example",
          "url": "https://rideguide.example/best-bike-shops/",
          "anchor": "Bike World",
          "title": "The best online bike shops"
        }
      ],
      "pageKind": "review",
      "pageKindBy": "ai"
    },
    "status": "contacted",
    "statusAt": "2026-10-02T09:30:00.000Z",
    "statusAuto": false,
    "note": "Emailed the editor on Oct 2.",
    "tags": [
      "gear-review"
    ],
    "firstSeen": "2026-09-14T03:00:00.000Z",
    "lastSeen": "2026-10-05T03:00:00.000Z",
    "gone": false,
    "check": {
      "at": "2026-10-05T03:10:00.000Z",
      "ok": true,
      "status": 200,
      "linksUs": false,
      "mentionsUs": false,
      "matched": []
    },
    "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/outreach?open=0b2d4f6a-8c0e-4a2c-9e4a-8c0e2a4c6e8a"
  }
}

{
  "error": {
    "code": "nothing_to_change",
    "message": "Send status, note, tags or a mix of them."
  }
}

{
  "error": {
    "code": "missing_key",
    "message": "Send the key as Authorization: Bearer mr_site_…"
  }
}

{
  "error": {
    "code": "missing_scope",
    "message": "This key does not have the scope this call needs."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Outreach target not found."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "More than 1200 requests this hour for this key."
  }
}