solarOSsolarOS Docs

Repair an External Reference target

Repoints one existing tenant-scoped External Reference only when expectedCurrentResourceType and expectedCurrentResourceId exactly match the current target. Missing tuples return 404; stale guards return 409. Required scope: external_references:write.

PATCH
/external-references

Repoints one existing tenant-scoped External Reference only when expectedCurrentResourceType and expectedCurrentResourceId exactly match the current target. Missing tuples return 404; stale guards return 409. Required scope: external_references:write.

Authorization

Authorization<token>

Organization API key. Format: Bearer sk_live_...

In: header

Request Body

application/json

JSON request payload for repairExternalReference.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/external-references" \  -H "Content-Type: application/json" \  -d '{    "resourceType": "WorkOrder",    "resourceId": "work_order_456",    "expectedCurrentResourceType": "WorkOrder",    "expectedCurrentResourceId": "work_order_123",    "externalSystem": "salesforce",    "externalObject": "WorkOrder",    "externalId": "0WO123"  }'
{  "data": {},  "meta": {    "requestId": "string",    "version": "v1",    "timestamp": "2019-08-24T14:15:22Z",    "rateLimit": {      "limit": 0,      "remaining": 0,      "reset": 0    }  }}