Confirm guessed company matches
curl --request POST \
--url https://api.neoagent.io/public-api/company-links/confirm-matches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"confirmations": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
]
}
'import requests
url = "https://api.neoagent.io/public-api/company-links/confirm-matches"
payload = { "confirmations": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({confirmations: [{external_id: '<string>', psa_company_id: '<string>'}]})
};
fetch('https://api.neoagent.io/public-api/company-links/confirm-matches', 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.neoagent.io/public-api/company-links/confirm-matches",
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([
'confirmations' => [
[
'external_id' => '<string>',
'psa_company_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.neoagent.io/public-api/company-links/confirm-matches"
payload := strings.NewReader("{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.neoagent.io/public-api/company-links/confirm-matches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neoagent.io/public-api/company-links/confirm-matches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"confirmed": 123,
"skipped": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
]
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timings_ms": {},
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"warnings": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}End companies
Confirm guessed company matches
Confirms up to 100 guessed matches of one integration, the same change as selecting rows and clicking Confirm on the Organization Mapping tab. Each confirmation names a row of GET /public-api/company-links?status=to_confirm: its external_id and psa_company_id. Each becomes a MANUAL link that later syncs keep, so end-user documentation search, Neo Pulse and the phone also read it. Only an admin or owner may call it: a key acting for anyone else is 403. A confirmation whose entity no longer holds that guess (a sync or a person changed it since the list was read), or whose match is already sure, comes back in skipped and nothing changes for it. M365, SLACK and SHAREPOINT are 400, because no sync guesses their links.
POST
/
public-api
/
company-links
/
confirm-matches
Confirm guessed company matches
curl --request POST \
--url https://api.neoagent.io/public-api/company-links/confirm-matches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"confirmations": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
]
}
'import requests
url = "https://api.neoagent.io/public-api/company-links/confirm-matches"
payload = { "confirmations": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({confirmations: [{external_id: '<string>', psa_company_id: '<string>'}]})
};
fetch('https://api.neoagent.io/public-api/company-links/confirm-matches', 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.neoagent.io/public-api/company-links/confirm-matches",
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([
'confirmations' => [
[
'external_id' => '<string>',
'psa_company_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.neoagent.io/public-api/company-links/confirm-matches"
payload := strings.NewReader("{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.neoagent.io/public-api/company-links/confirm-matches")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neoagent.io/public-api/company-links/confirm-matches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"confirmations\": [\n {\n \"external_id\": \"<string>\",\n \"psa_company_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"confirmed": 123,
"skipped": [
{
"external_id": "<string>",
"psa_company_id": "<string>"
}
]
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timings_ms": {},
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"warnings": [
"<string>"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Authorizations
Body
application/json
Available options:
ITGLUE, NINJA, DATTO, CW_ASIO, CW_AUTOMATE, NCENTRAL, NSIGHT, VSAX, SCREENCONNECT, SYNCRO_RMM, ADDIGY, CONFLUENCE, CONFLUENCE_PAGE, HUDU, LEXFUL, SHAREPOINT, M365, SLACK, ACRONIS, AFAS_PROFIT, ARROWSPHERE, ARUBA_CENTRAL, AUTOELEVATE, AUVIK, AVANAN, AXCIENT, AZURE_RESOURCE_MANAGER, BEYONDTRUST_EPM, BICOM_PBXWARE, BIGLEAF, BLACKPOINT, BREACH_SECURE_NOW, BVOIP, CALL_HARBOR, CALLSWITCH_ONE, CIPP, CISCO_UMBRELLA, CLOUDRADIAL, CONTROLD, CORK, COVE, CRADLEPOINT, CROWDSTRIKE, CYBERQP, D_AND_H, DARK_WEB_ID, DATTO_BCDR, DATTO_EDR, DATTO_NETWORKING, DEFENSX, DNSFILTER, DOMOTZ, DRAYTEK_VIGORACS, DUO, ELEVATE, EVERNEX, EXCLAIMER, FIELD_EFFECT, FORTIGATE, FORTIMAIL, FORTIMANAGER, GLASSHIVE, GODADDY, HIGHLEVEL, HORNETSECURITY, HPE_GREENLAKE, HUBSPOT, HUNTRESS, IMMYBOT, INFORCER, INGRAM_MICRO, INKY, IRONSCALES, ITCLOUD, KASEYA_QUOTE_MANAGER, KEEPIT, LEVEL_RMM, LIONGARD, LOGICMONITOR, MAILPROTECTOR, MERAKI, MIMECAST, MPS_MONITOR, MSPORTAL, MYITPROCESS, NERDIO, NINJAONE_SAAS_BACKUP, OMADA, OPENTEXT, PAX8, PETRA, PROOFPOINT_ESSENTIALS, PRTG, QUICKBOOKS_ONLINE, REDSTOR, ROBOSHADOW, ROCKETCYBER, ROUTIT, SAAS_ALERTS, SASBOSS, SCOUTDNS, SENTINELONE, SHERWEB, SKYSWITCH, SLIDE, SONICWALL, SOPHOS, TD_SYNNEX, TD_SYNNEX_STELLR, THREATLOCKER, TODYL, TREND_MICRO_LMP, TRIDENTSTACK, UNIFI, UNIVIEW, USECURE, VEEAM_SPC, VEEAM_VB365, WATCHGUARD, WIZER, WOSP, XERO, ZOEY, ZOHO_DESK, ZORUS Response
Success.
