Skip to content
Orvanov0.2.0

users.createRecovery

POST
/v1/users/{userId}/recovery
import { Client, Orvano } from '@orvano/js/server'
const orvano = new Orvano(
new Client({ endpoint: 'https://orvano.example.com', apiKey: process.env.ORVANO_API_KEY }),
)
await orvano.users.createRecovery('<userId>', {
redirectUrl: 'https://app.example.com/auth/callback',
})

Emails a user a password reset link.

Server SDKs: JavaScript on a server, Dart, and .NET call it with an API key. API key scope: users.write. A failure answers with a problem details body; its code has a page under Errors.

userId
required
string

The user ID.

Media typeapplication/json

A request to email a user a password reset link.

object
redirectUrl
required

The page that receives the link, on a host that is one of the project’s web platforms (http only on localhost or 127.0.0.1). The link adds orvano_type=recovery and orvano_token to it.

string

The request has been accepted for processing, but processing has not yet completed.

An unexpected error response.

Media typeapplication/problem+json

An RFC 9457 problem details body. Every operation declares it as its default response, sent as application/problem+json.

object
type
required

Identifies the error: https://orvano.dev/errors/<code>.

string
title
required

The standard HTTP reason phrase for the status.

string
status
required

The HTTP status code.

integer format: int32
detail

A short, safe sentence about this occurrence, when the server has one.

string
code
required

Orvano’s stable error code, from the ErrorCode catalog. SDKs treat it as a plain string.

string
requestId
required

The request ID to quote when reporting a problem; also sent as X-Request-Id.

string
Example
{
"type": "https://orvano.dev/errors/not_found",
"title": "Not Found",
"status": 404,
"code": "not_found",
"requestId": "4bf92f3577b34da6a3ce929d0e0e4736"
}