Correct an attribution

POST/lokta-lms/api/v1/loan-attributions/{id}/corrections

Moves a loan to a different partner, or back to Direct.

Move a loan to a different partner, or, with partner_id: null, back to Direct.

One verb for both, because they are one event: the loan's introducer changed. Two verbs would give one fact two audit trails, and the trail is the entire reason corrections are allowed at all.

reason is mandatory (422 sourcing/correction_reason_required). This changes who is paid for a loan, so a correction with no stated cause is indistinguishable from fraud when someone reads it back. A correction that leaves the attribution unchanged is refused rather than recorded; a reason logged against an event that never happened is worse than no record, because a later reader cannot tell it from a real change.

Path parameters

idpath · string · required

Opaque attribution id, spa_…

Header parameters

Idempotency-Keyheader · string · optional

Per-intent key

Request body application/json

reasonstring · required

Required. A correction with no stated cause is refused.

partner_idstring · optional

The partner the loan moves to. Null moves it back to Direct.

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 POST \ 'https://default.lokta.tech/lokta-lms/api/v1/loan-attributions/{id}/corrections' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "reason": "string", "partner_id": "string" }'

import requests response = requests.post( "https://default.lokta.tech/lokta-lms/api/v1/loan-attributions/{id}/corrections", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "reason": "string", "partner_id": "string" }, ) print(response.json())

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

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

payload := strings.NewReader(`{ "reason": "string", "partner_id": "string" }`) req, _ := http.NewRequest("POST", "https://default.lokta.tech/lokta-lms/api/v1/loan-attributions/{id}/corrections", 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))