Create a New Role

POST/lokta-lms/api/v1/roles

Creates a role. Grant it permissions afterwards with the role permissions endpoint.

Mandatory Fields
name, description

Request body application/json

descriptionstring · optional

namestring · optional

Responses

200OK

Response fields

resourceIdinteger · int64 · optional

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/roles' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "description": "A description outlining the purpose of this role in relation to the application.", "name": "Another Role Name" }'

import requests response = requests.post( "https://default.lokta.tech/lokta-lms/api/v1/roles", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "description": "A description outlining the purpose of this role in relation to the application.", "name": "Another Role Name" }, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/roles", { method: "POST", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", "Content-Type": "application/json", }, body: JSON.stringify({ "description": "A description outlining the purpose of this role in relation to the application.", "name": "Another Role Name" }), }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/roles")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString(""" { "description": "A description outlining the purpose of this role in relation to the application.", "name": "Another Role Name" } """)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

payload := strings.NewReader(`{ "description": "A description outlining the purpose of this role in relation to the application.", "name": "Another Role Name" }`) req, _ := http.NewRequest("POST", "https://default.lokta.tech/lokta-lms/api/v1/roles", 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))