Create a new app
header Parameters
Authorization required | string API Secret token |
X-Authorization required | string User Access token |
Request Body schema: multipart/form-data
name | string Application name |
origin | string Url of the Application |
colors | string Color array ([hex]) |
callback_url | string Callback url (used for oauth) |
login_url | string Login url |
Responses
Sends a login magic link to the user
Send a login email to the user. The user will receive an email with a link to complete their login
path Parameters
app_id required | number |
Request Body schema: multipart/form-datarequired
identifier required | string Email or phone (coming soon / WIP) |
webauthn_enabled | string Enum: true false "true" "false" Email or phone (coming soon / WIP) |
Responses
Sends a register magic link to the user
Send a register email to the user. The user will receive an email with a link to complete their login
path Parameters
app_id required | number |
Request Body schema: multipart/form-datarequired
identifier required | string Email or phone (coming soon / WIP) |
webauthn_enabled | string Enum: true false "true" "false" Email or phone (coming soon / WIP) |
Responses
Check status of a magic link (a.k.a. X-Login)
Check if a magic link has been activated yet or not. Once the magic link has been activated, this endpoint will return an authentication token for the user. This endpoint can be used to initiate a login on one device and then poll and wait for the login to complete on another device.
path Parameters
app_id required | number |
Request Body schema: multipart/form-datarequired
id required | string Email or phone (coming soon / WIP) |
Responses
Create new user
Creates a new User with the given identifier, and returns a simplified user object, and sends a magic link to confirm the email address.
path Parameters
app_id required | number |
Request Body schema: multipart/form-datarequired
identifier required | string Valid user identifier (email) |
user_meta | string User meta data |
Responses
List, search, filter users for an app
path Parameters
app_id required | number |
query Parameters
id | string id of the requested user |
string Search with email | |
phone | string Search with phone |
created_before | string Filter all created before this date |
status | string Enum: "active" "pending" "inactive" Filter by status |
page | string Page number |
limit | string Limit number of results in a page |
header Parameters
Authorization required | string API Secret token |
Responses
Invite a new user to the app
Creates a user with :pending status and sends an invitation email to the user.
path Parameters
app_id required | number |
id required | number |
header Parameters
Authorization required | string API Secret token |
X-Authorization required | string User Access token |
Request Body schema: multipart/form-datarequired
identifier required | string Email address for the user to invite |
user_meta | string User metadata for the created user |
Responses
Refreshes access token with API Secret
Allows for http-only cookie based access token rotation from server-side to Scute API (Specifically for Next.js (scute-next-js))
path Parameters
app_id required | number |
header Parameters
X-Authorization required | string User Access token |
Authorization required | string API Secret token |
Responses
Refreshes access token with Refresh token and API Secret
Allows for http-only cookie based token refresh from server-side to Scute API
path Parameters
app_id required | number |
header Parameters
X-Refresh-Token required | string User Refresh token |
X-CSRF-Token required | string CSRF token |
Authorization required | string API Secret token |
Responses
Initiate a WebAuthn login (Credential auth ceremony)
SDK hits this endpoint to login the webauthn credentials for a user) -- Do not use it manually unless you know what you are doing and have a good reason to do so. Use the SDK instead.
path Parameters
app_id required | number |
Request Body schema: multipart/form-datarequired
identifier required | string Valid user identifier (email) |
Responses
Upsert auth provider for the app
path Parameters
app_id required | number |
header Parameters
Authorization required | string API Secret token |
Request Body schema: multipart/form-datarequired
auth_provider[slug] required | string |
auth_provider[client_id] required | string |
auth_provider[client_secret] required | string |
Responses
Create a metafield
path Parameters
app_id required | number |
header Parameters
Authorization required | string API Secret token |
X-Authorization required | string User Access token |
Request Body schema: multipart/form-datarequired
name required | string Meta field name |
field_type required | string Enum: "string" "boolean" "integer" "date" "phone" "email" "text" "url" Type |
required | string Enum: "true" "false" Required |
visible_profile | string Enum: "true" "false" Visible on profile component |
visible_registration | string Enum: "true" "false" Visible on registration / login component |
position | number Position |
Responses
Update a metafield
path Parameters
app_id required | number |
id required | number |
header Parameters
Authorization required | string API Secret token |
X-Authorization required | string User Access token |
Request Body schema: multipart/form-datarequired
name required | string Meta field name |
field_type required | string Enum: "string" "boolean" "integer" "date" "phone" "email" "text" "url" Type |
required | string Enum: "true" "false" Required |
visible_profile | string Enum: "true" "false" Visible on profile component |
visible_registration | string Enum: "true" "false" Visible on registration / login component |
position | number Position |