Redirect URLs

Redirect URLs are whitelisted URLs that facilitate secure authentication flows in native applications (e.g. React Native, Expo). In these contexts, Clerk ensures that security-critical nonces are passed only to the whitelisted URLs.

List all redirect URLs

Lists all whitelisted redirect_urls for the instance

SecuritybearerAuth
Responses
200

List of Redirect URLs

get/redirect_urls
Response samples
application/json
[
  • {
    }
]

Create a redirect URL

Create a redirect URL

SecuritybearerAuth
Request
Request Body schema: application/json
url
string

The full url value prefixed with https:// or a custom scheme e.g. "https://my-app.com/oauth-callback" or "my-app://oauth-callback"

Responses
200

Success

400

Request was not successful

422

Invalid request parameters

post/redirect_urls
Request samples
application/json
{
  • "url": "string"
}
Response samples
application/json
{
  • "object": "redirect_url",
  • "id": "string",
  • "url": "string",
  • "created_at": 0,
  • "updated_at": 0
}

Retrieve a redirect URL

Retrieve the details of the redirect URL with the given ID

SecuritybearerAuth
Request
path Parameters
id
required
string

The ID of the redirect URL

Responses
200

Success

404

Resource not found

get/redirect_urls/{id}
Response samples
application/json
{
  • "object": "redirect_url",
  • "id": "string",
  • "url": "string",
  • "created_at": 0,
  • "updated_at": 0
}

Delete a redirect URL

Remove the selected redirect URL from the whitelist of the instance

SecuritybearerAuth
Request
path Parameters
id
required
string

The ID of the redirect URL

Responses
200

Deleted Object

404

Resource not found

delete/redirect_urls/{id}
Response samples
application/json
{
  • "object": "string",
  • "id": "string",
  • "slug": "string",
  • "deleted": true
}