SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Update a prospect: status, contact, owner, notes or follow-up date

PATCHhttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects/{prospect_id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired
prospect_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

source_urlstring

Page you want a link from.

target_urlstring

Page on the site the link should point to.

contact_namestring

Who to ask.

contact_emailstring

Their email.

suggested_anchorstring

Anchor text to ask for.

statusstring

Outreach state.

owner_user_idinteger

Member who owns the outreach.

notesstring

Free-text notes.

next_follow_up_onstring

Date of the next follow-up (YYYY-MM-DD).

Response

Response Body

idstringProspect id. Use it as prospect_id.
source_urlstringPage you want a link from.
source_domainstringDomain of that page.
contact_namestring | nullWho to ask.
contact_emailstring | nullTheir email.
target_urlstring | nullPage on the site the link should point to.
suggested_anchorstring | nullAnchor text to ask for.
statusstringOutreach state.
sourcestringWhere the prospect came from: added by hand, a brand mention, the API, an import, or a site an AI answer cited.
owner_user_idinteger | nullMember chasing it.
notesstring | nullFree-text notes.
next_follow_up_onstring | nullWhen the next follow-up is due.
last_verified_atstring | nullLast time the page was checked for the link.
verification_statusstring | nullResult of the last check.
backlink_idstring | nullBacklink created once the link went live.
created_atstringCreation time.
updated_atstringLast change.

Request

curl --request PATCH \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects/{prospect_id} \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"source_url": "https://partner.example.org/resources",
"target_url": "https://acmebakery.co.uk/guides/sourdough",
"contact_name": "Jo Baker",
"contact_email": "jo@partner.example.org",
"suggested_anchor": "sourdough starter guide",
"notes": "Met at the food fair.",
"next_follow_up_on": "2026-09-20"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"source_url": "https://partner.example.org/resources",
"source_domain": "partner.example.org",
"contact_name": "Jo Baker",
"contact_email": "jo@partner.example.org",
"target_url": null,
"suggested_anchor": null,
"status": "prospect",
"source": "manual",
"owner_user_id": 12,
"notes": null,
"next_follow_up_on": null,
"last_verified_at": null,
"verification_status": "missing",
"backlink_id": null,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
}
}