Clerk docs

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
Request
query Parameters
paginated
boolean

Whether to paginate the results. If true, the results will be paginated. If false, the results will not be paginated.

limit
integer [ 1 .. 500 ]
Default: 10

Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

offset
integer >= 0
Default: 0

Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

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
required
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
}
➔ Next to SAML Connections