Correct a partner's details

PATCH/lokta-lms/api/v1/sourcing-partners/{id}

Corrects the details of a sourcing partner.

Null means "leave alone", never "clear". A form carrying three fields must not erase the twenty it has no input for. To blank a value, send an empty string.

status is not accepted here. A partner is activated and deactivated through …/activation, where the change carries a reason and lands in the status history; allowing it on a PATCH would let the one transition anybody audits happen as a silent field assignment.

external_id may be corrected, so a typo at onboarding is not permanent; uniqueness still applies (409 sourcing/external_id_taken).

details merges column by column and is created if the partner never had one; a partner given a PAN today must not lose the GSTIN somebody added last week. gst_treatment is re-derived whenever the GSTIN changes, because it is a consequence of that field rather than an independent one; leaving it stale would put a partner on forward charge with no GSTIN, or the reverse.

Path parameters

idpath · string · required

Opaque partner id, spr_…

Header parameters

Idempotency-Keyheader · string · optional

Per-intent key

Request body application/json

external_idstring · optional

The partner's external id. Uniqueness still applies.

detailsobject · optional

Merged column by column. Null leaves a value alone; an empty string blanks it.

Responses

defaultdefault response

Every request authenticates with HTTP Basic and carries a Tenant-Identifier header. See the conventions for dates, commands, pagination and errors. Open this operation in the interactive explorer, or read it as Markdown.

This is the API reference for Lokta, the agentic loan servicing platform. Go to lokta.ai

curl -X PATCH \ 'https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{id}' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "external_id": "string", "details": {} }'

import requests response = requests.patch( "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{id}", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "external_id": "string", "details": {} }, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{id}", { method: "PATCH", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", "Content-Type": "application/json", }, body: JSON.stringify({ "external_id": "string", "details": {} }), }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{id}")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .header("Content-Type", "application/json") .method("PATCH", HttpRequest.BodyPublishers.ofString(""" { "external_id": "string", "details": {} } """)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

payload := strings.NewReader(`{ "external_id": "string", "details": {} }`) req, _ := http.NewRequest("PATCH", "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{id}", payload) req.SetBasicAuth("{username}", "{password}") req.Header.Set("Tenant-Identifier", "default") req.Header.Set("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data))