curl --request POST \
--url https://api.next.orenda.finance/v1/auth/change-password \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-program-id: <x-program-id>' \
--data '
{
"email": "ada.lovelace@example.com",
"temporary_password": "Temp-Pass-9281",
"new_password": "N3w-S3cur3-P@ss!"
}
'import requests
url = "https://api.next.orenda.finance/v1/auth/change-password"
payload = {
"email": "ada.lovelace@example.com",
"temporary_password": "Temp-Pass-9281",
"new_password": "N3w-S3cur3-P@ss!"
}
headers = {
"x-program-id": "<x-program-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-program-id': '<x-program-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'ada.lovelace@example.com',
temporary_password: 'Temp-Pass-9281',
new_password: 'N3w-S3cur3-P@ss!'
})
};
fetch('https://api.next.orenda.finance/v1/auth/change-password', 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.next.orenda.finance/v1/auth/change-password",
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([
'email' => 'ada.lovelace@example.com',
'temporary_password' => 'Temp-Pass-9281',
'new_password' => 'N3w-S3cur3-P@ss!'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-program-id: <x-program-id>"
],
]);
$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.next.orenda.finance/v1/auth/change-password"
payload := strings.NewReader("{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-program-id", "<x-program-id>")
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.next.orenda.finance/v1/auth/change-password")
.header("x-program-id", "<x-program-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v1/auth/change-password")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-program-id"] = '<x-program-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"authenticated": false,
"challenge": "SECURITY_SETUP_REQUIRED",
"session_token": "3f1c2e8a-9b4d-4e6f-8a1b-2c3d4e5f6a7b"
}
}Change a temporary password
Replaces a temporary password (issued by an admin reset) with a real one. This also logs the user in: if they already have a passkey or 2FA you get tokens, otherwise a SECURITY_SETUP_REQUIRED challenge with a session_token to take into security setup.
For new integrations use POST /v2/auth/change-password, which takes and returns camelCase field names (sessionToken, accessToken, …). This v1 route is unchanged.
curl --request POST \
--url https://api.next.orenda.finance/v1/auth/change-password \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-program-id: <x-program-id>' \
--data '
{
"email": "ada.lovelace@example.com",
"temporary_password": "Temp-Pass-9281",
"new_password": "N3w-S3cur3-P@ss!"
}
'import requests
url = "https://api.next.orenda.finance/v1/auth/change-password"
payload = {
"email": "ada.lovelace@example.com",
"temporary_password": "Temp-Pass-9281",
"new_password": "N3w-S3cur3-P@ss!"
}
headers = {
"x-program-id": "<x-program-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-program-id': '<x-program-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'ada.lovelace@example.com',
temporary_password: 'Temp-Pass-9281',
new_password: 'N3w-S3cur3-P@ss!'
})
};
fetch('https://api.next.orenda.finance/v1/auth/change-password', 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.next.orenda.finance/v1/auth/change-password",
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([
'email' => 'ada.lovelace@example.com',
'temporary_password' => 'Temp-Pass-9281',
'new_password' => 'N3w-S3cur3-P@ss!'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-program-id: <x-program-id>"
],
]);
$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.next.orenda.finance/v1/auth/change-password"
payload := strings.NewReader("{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-program-id", "<x-program-id>")
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.next.orenda.finance/v1/auth/change-password")
.header("x-program-id", "<x-program-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v1/auth/change-password")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-program-id"] = '<x-program-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"ada.lovelace@example.com\",\n \"temporary_password\": \"Temp-Pass-9281\",\n \"new_password\": \"N3w-S3cur3-P@ss!\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"authenticated": false,
"challenge": "SECURITY_SETUP_REQUIRED",
"session_token": "3f1c2e8a-9b4d-4e6f-8a1b-2c3d4e5f6a7b"
}
}Authorizations
The user's access token from authentication. The program and environment come from the token.
Headers
Identifies the program. Can also be sent as the programId query parameter.
Body
Response
The security setup challenge. Changing the temporary password logs the user in but never returns tokens directly: the response is always a SECURITY_SETUP_REQUIRED challenge. Take the session_token into the security setup flow (passkey or 2FA) to get tokens.