Skip to main content

Logto Core (0.1.0)

Download OpenAPI specification:Download

Interaction

/api/interaction

Request Body schema: application/json
event
required
string
Enum: "SignIn" "Register" "ForgotPassword"
object or object or object or object or object or object or object or object
object

Responses

Request samples

Content type
application/json
{
  • "event": "SignIn",
  • "identifier": {
    },
  • "profile": {
    }
}

/api/interaction

Responses

/api/interaction/event

Request Body schema: application/json
event
required
string
Enum: "SignIn" "Register" "ForgotPassword"

Responses

Request samples

Content type
application/json
{
  • "event": "SignIn"
}

/api/interaction/identifiers

Request Body schema: application/json
One of
username
required
string non-empty
password
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "connectorId": "string",
  • "phone": "string"
}

/api/interaction/profile

Request Body schema: application/json
username
string <regex> /^[A-Z_a-z]\w*$/
email
string <regex> /^\[email protected]\S+\.\S+$/
phone
string <regex> /^\d+$/
connectorId
string
password
string <regex> /^((?=.*\d)(?=.*[A-Za-z])|(?=.*\d)(?=.*[!"#$%...

Responses

Request samples

Content type
application/json
{
  • "username": "/regex/",
  • "email": "/regex/",
  • "phone": "/regex/",
  • "connectorId": "string",
  • "password": "/regex/"
}

/api/interaction/profile

Request Body schema: application/json
username
string <regex> /^[A-Z_a-z]\w*$/
email
string <regex> /^\[email protected]\S+\.\S+$/
phone
string <regex> /^\d+$/
connectorId
string
password
string <regex> /^((?=.*\d)(?=.*[A-Za-z])|(?=.*\d)(?=.*[!"#$%...

Responses

Request samples

Content type
application/json
{
  • "username": "/regex/",
  • "email": "/regex/",
  • "phone": "/regex/",
  • "connectorId": "string",
  • "password": "/regex/"
}

/api/interaction/profile

Responses

/api/interaction/submit

Responses

/api/interaction/verification/social-authorization-uri

Request Body schema: application/json
connectorId
required
string
state
required
string
redirectUri
required
object

Validator function

Responses

Request samples

Content type
application/json
{
  • "connectorId": "string",
  • "state": "string",
  • "redirectUri": { }
}

/api/interaction/verification/verification-code

Request Body schema: application/json
One of
email
required
string <regex> /^\[email protected]\S+\.\S+$/

Responses

Request samples

Content type
application/json
{
  • "phone": "/regex/"
}

/api/interaction/consent

Responses

Applications

/api/applications

query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/applications

Request Body schema: application/json
tenantId
string <= 21 characters
name
required
string <= 256 characters
secret
string <= 64 characters
description
string or null
type
required
string
Enum: "Native" "SPA" "Traditional" "MachineToMachine"
object
object

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "name": "string",
  • "secret": "string",
  • "description": "string",
  • "type": "Native",
  • "oidcClientMetadata": {
    },
  • "customClientMetadata": {
    }
}

/api/applications/:id

path Parameters
id
required
string non-empty

Responses

/api/applications/:id

path Parameters
id
required
string non-empty
Request Body schema: application/json
tenantId
string <= 21 characters
name
string <= 256 characters
secret
string <= 64 characters
description
string or null
type
string
Enum: "Native" "SPA" "Traditional" "MachineToMachine"
object
object
isAdmin
boolean

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "name": "string",
  • "secret": "string",
  • "description": "string",
  • "type": "Native",
  • "oidcClientMetadata": {
    },
  • "customClientMetadata": {
    },
  • "isAdmin": true
}

/api/applications/:id

path Parameters
id
required
string non-empty

Responses

Configs

/api/configs/admin-console

Responses

/api/configs/admin-console

Request Body schema: application/json
livePreviewChecked
boolean
applicationCreated
boolean
signInExperienceCustomized
boolean
passwordlessConfigured
boolean
communityChecked
boolean
furtherReadingsChecked
boolean
roleCreated
boolean
m2mApplicationCreated
boolean

Responses

Request samples

Content type
application/json
{
  • "livePreviewChecked": true,
  • "applicationCreated": true,
  • "signInExperienceCustomized": true,
  • "passwordlessConfigured": true,
  • "communityChecked": true,
  • "furtherReadingsChecked": true,
  • "roleCreated": true,
  • "m2mApplicationCreated": true
}

Connectors

/api/connectors

query Parameters
target
string

Responses

/api/connectors

Request Body schema: application/json
config
object

arbitrary

connectorId
required
string <= 128 characters
object
syncProfile
boolean
id
string <= 128 characters

Responses

Request samples

Content type
application/json
{
  • "config": { },
  • "connectorId": "string",
  • "metadata": {
    },
  • "syncProfile": true,
  • "id": "string"
}

/api/connectors/:id

path Parameters
id
required
string non-empty

Responses

/api/connectors/:id

path Parameters
id
required
string non-empty
Request Body schema: application/json
config
object

arbitrary

object
syncProfile
boolean

Responses

Request samples

Content type
application/json
{
  • "config": { },
  • "metadata": {
    },
  • "syncProfile": true
}

/api/connectors/:id

path Parameters
id
required
string non-empty

Responses

/api/connectors/:factoryId/test

path Parameters
factoryId
required
string non-empty
Request Body schema: application/json
phone
string <regex> /^\d+$/
email
string <regex> /^\[email protected]\S+\.\S+$/
config
required
object

arbitrary

Responses

Request samples

Content type
application/json
{
  • "phone": "/regex/",
  • "email": "/regex/",
  • "config": { }
}

Connector Factories

/api/connector-factories

Responses

/api/connector-factories/:id

path Parameters
id
required
string non-empty

Responses

Resources

/api/resources

query Parameters
includeScopes
string
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/resources

Request Body schema: application/json
tenantId
string <= 21 characters
name
required
string
indicator
required
string
accessTokenTtl
number

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "name": "string",
  • "indicator": "string",
  • "accessTokenTtl": 0
}

/api/resources/:id

path Parameters
id
required
string non-empty

Responses

/api/resources/:id

path Parameters
id
required
string non-empty
Request Body schema: application/json
tenantId
string <= 21 characters
name
string
indicator
string
accessTokenTtl
number

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "name": "string",
  • "indicator": "string",
  • "accessTokenTtl": 0
}

/api/resources/:id

path Parameters
id
required
string non-empty

Responses

/api/resources/:resourceId/scopes

path Parameters
resourceId
required
string non-empty
query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/resources/:resourceId/scopes

path Parameters
resourceId
required
string non-empty
Request Body schema: application/json
name
required
string <= 256 characters
description
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string"
}

/api/resources/:resourceId/scopes/:scopeId

path Parameters
resourceId
required
string non-empty
scopeId
required
string non-empty
Request Body schema: application/json
name
required
string <= 256 characters
description
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string"
}

/api/resources/:resourceId/scopes/:scopeId

path Parameters
resourceId
required
string non-empty
scopeId
required
string non-empty

Responses

Sign In Exp

/api/sign-in-exp

Responses

/api/sign-in-exp

query Parameters
removeUnusedDemoSocialConnector
string
Request Body schema: application/json
tenantId
string <= 21 characters
object
object
object
object
object
socialSignInConnectorTargets
Array of strings
signInMode
string
Enum: "SignIn" "Register" "SignInAndRegister"
customCss
string or null
object
(string or null) or string
(string or null) or string

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "color": {
    },
  • "branding": {
    },
  • "languageInfo": {
    },
  • "signIn": {
    },
  • "signUp": {
    },
  • "socialSignInConnectorTargets": [
    ],
  • "signInMode": "SignIn",
  • "customCss": "string",
  • "customContent": {
    },
  • "termsOfUseUrl": "string",
  • "privacyPolicyUrl": "string"
}

Users

/api/users

query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/users

Request Body schema: application/json
primaryPhone
string <regex> /^\d+$/
primaryEmail
string <regex> /^\[email protected]\S+\.\S+$/
username
string <regex> /^[A-Z_a-z]\w*$/
password
string <regex> /^((?=.*\d)(?=.*[A-Za-z])|(?=.*\d)(?=.*[!"#$%...
name
string

Responses

Request samples

Content type
application/json
{
  • "primaryPhone": "/regex/",
  • "primaryEmail": "/regex/",
  • "username": "/regex/",
  • "password": "/regex/",
  • "name": "string"
}

/api/users/:userId

path Parameters
userId
required
string

Responses

/api/users/:userId

path Parameters
userId
required
string
Request Body schema: application/json
(string or null) or (string or null)
(string or null) or (string or null)
(string or null) or (string or null)
(string or null) or (string or null)
(string or null) or (string or null)
customData
object

arbitrary

Responses

Request samples

Content type
application/json
{
  • "username": "/regex/",
  • "primaryEmail": "/regex/",
  • "primaryPhone": "/regex/",
  • "name": "string",
  • "avatar": "string",
  • "customData": { }
}

/api/users/:userId

path Parameters
userId
required
string

Responses

/api/users/:userId/custom-data

path Parameters
userId
required
string

Responses

/api/users/:userId/custom-data

path Parameters
userId
required
string
Request Body schema: application/json
customData
required
object

arbitrary

Responses

Request samples

Content type
application/json
{
  • "customData": { }
}

/api/users/:userId/password

path Parameters
userId
required
string
Request Body schema: application/json
password
required
string <regex> /^((?=.*\d)(?=.*[A-Za-z])|(?=.*\d)(?=.*[!"#$%...

Responses

Request samples

Content type
application/json
{
  • "password": "/regex/"
}

/api/users/:userId/is-suspended

path Parameters
userId
required
string
Request Body schema: application/json
isSuspended
required
boolean

Responses

Request samples

Content type
application/json
{
  • "isSuspended": true
}

/api/users/:userId/identities/:target

path Parameters
userId
required
string
target
required
string

Responses

/api/users/:userId/roles

path Parameters
userId
required
string
query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/users/:userId/roles

path Parameters
userId
required
string
Request Body schema: application/json
roleIds
required
Array of strings[ items non-empty ]

Responses

Request samples

Content type
application/json
{
  • "roleIds": [
    ]
}

/api/users/:userId/roles

path Parameters
userId
required
string
Request Body schema: application/json
roleIds
required
Array of strings[ items non-empty ]

Responses

Request samples

Content type
application/json
{
  • "roleIds": [
    ]
}

/api/users/:userId/roles/:roleId

path Parameters
userId
required
string
roleId
required
string

Responses

Logs

/api/logs

query Parameters
userId
string
applicationId
string
logKey
string
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/logs/:id

path Parameters
id
required
string non-empty

Responses

Roles

/api/roles

query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/roles

Request Body schema: application/json
tenantId
string <= 21 characters
name
required
string <= 128 characters
description
required
string <= 128 characters
scopeIds
Array of strings[ items non-empty ]

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "name": "string",
  • "description": "string",
  • "scopeIds": [
    ]
}

/api/roles/:id

path Parameters
id
required
string non-empty

Responses

/api/roles/:id

path Parameters
id
required
string non-empty
Request Body schema: application/json
name
string <= 128 characters
description
string <= 128 characters

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string"
}

/api/roles/:id

path Parameters
id
required
string non-empty

Responses

/api/roles/:id/users

path Parameters
id
required
string non-empty
query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/roles/:id/users

path Parameters
id
required
string non-empty
Request Body schema: application/json
userIds
required
Array of strings[ items non-empty ]

Responses

Request samples

Content type
application/json
{
  • "userIds": [
    ]
}

/api/roles/:id/users/:userId

path Parameters
id
required
string non-empty
userId
required
string non-empty

Responses

/api/roles/:id/scopes

path Parameters
id
required
string non-empty
query Parameters
page
integer >= 1
Default: 1
page_size
integer >= 1
Default: 20

Responses

/api/roles/:id/scopes

path Parameters
id
required
string non-empty
Request Body schema: application/json
scopeIds
required
Array of strings[ items non-empty ]

Responses

Request samples

Content type
application/json
{
  • "scopeIds": [
    ]
}

/api/roles/:id/scopes/:scopeId

path Parameters
id
required
string non-empty
scopeId
required
string non-empty

Responses

Dashboard

/api/dashboard/users/total

Responses

/api/dashboard/users/new

Responses

/api/dashboard/users/active

query Parameters
date
string <regex> /^\d{4}(-\d{2}){2}/

Responses

Custom Phrases

/api/custom-phrases

Responses

/api/custom-phrases/:languageTag

path Parameters
languageTag
required
string
Enum: "af-ZA" "am-ET" "ar-AR" "as-IN" "az-AZ" "be-BY" "bg-BG" "bn-IN" "br-FR" "bs-BA" "ca-ES" "cb-IQ" "co-FR" "cs-CZ" "cx-PH" "cy-GB" "da-DK" "de" "de-DE" "el-GR" "en" "en-GB" "en-US" "eo-EO" "es" "es-ES" "es-419" "et-EE" "eu-ES" "fa-IR" "ff-NG" "fi-FI" "fo-FO" "fr" "fr-CA" "fr-FR" "fy-NL" "ga-IE" "gl-ES" "gn-PY" "gu-IN" "ha-NG" "he-IL" "hi-IN" "hr-HR" "ht-HT" "hu-HU" "hy-AM" "id-ID" "ik-US" "is-IS" "it" "it-IT" "iu-CA" "ja" "ja-JP" "ja-KS" "jv-ID" "ka-GE" "kk-KZ" "km-KH" "kn-IN" "ko" "ko-KR" "ku-TR" "ky-KG" "lo-LA" "lt-LT" "lv-LV" "mg-MG" "mk-MK" "ml-IN" "mn-MN" "mr-IN" "ms-MY" "mt-MT" "my-MM" "nb-NO" "ne-NP" "nl-BE" "nl-NL" "nn-NO" "or-IN" "pa-IN" "pl-PL" "ps-AF" "pt" "pt-BR" "pt-PT" "ro-RO" "ru" "ru-RU" "rw-RW" "sc-IT" "si-LK" "sk-SK" "sl-SI" "sn-ZW" "sq-AL" "sr-RS" "sv-SE" "sw-KE" "sy-SY" "sz-PL" "ta-IN" "te-IN" "tg-TJ" "th-TH" "tl-PH" "tr" "tr-TR" "tt-RU" "tz-MA" "uk-UA" "ur-PK" "uz-UZ" "vi-VN" "zh" "zh-CN" "zh-HK" "zh-MO" "zh-TW" "zz-TR"

Responses

/api/custom-phrases/:languageTag

path Parameters
languageTag
required
string
Enum: "af-ZA" "am-ET" "ar-AR" "as-IN" "az-AZ" "be-BY" "bg-BG" "bn-IN" "br-FR" "bs-BA" "ca-ES" "cb-IQ" "co-FR" "cs-CZ" "cx-PH" "cy-GB" "da-DK" "de" "de-DE" "el-GR" "en" "en-GB" "en-US" "eo-EO" "es" "es-ES" "es-419" "et-EE" "eu-ES" "fa-IR" "ff-NG" "fi-FI" "fo-FO" "fr" "fr-CA" "fr-FR" "fy-NL" "ga-IE" "gl-ES" "gn-PY" "gu-IN" "ha-NG" "he-IL" "hi-IN" "hr-HR" "ht-HT" "hu-HU" "hy-AM" "id-ID" "ik-US" "is-IS" "it" "it-IT" "iu-CA" "ja" "ja-JP" "ja-KS" "jv-ID" "ka-GE" "kk-KZ" "km-KH" "kn-IN" "ko" "ko-KR" "ku-TR" "ky-KG" "lo-LA" "lt-LT" "lv-LV" "mg-MG" "mk-MK" "ml-IN" "mn-MN" "mr-IN" "ms-MY" "mt-MT" "my-MM" "nb-NO" "ne-NP" "nl-BE" "nl-NL" "nn-NO" "or-IN" "pa-IN" "pl-PL" "ps-AF" "pt" "pt-BR" "pt-PT" "ro-RO" "ru" "ru-RU" "rw-RW" "sc-IT" "si-LK" "sk-SK" "sl-SI" "sn-ZW" "sq-AL" "sr-RS" "sv-SE" "sw-KE" "sy-SY" "sz-PL" "ta-IN" "te-IN" "tg-TJ" "th-TH" "tl-PH" "tr" "tr-TR" "tt-RU" "tz-MA" "uk-UA" "ur-PK" "uz-UZ" "vi-VN" "zh" "zh-CN" "zh-HK" "zh-MO" "zh-TW" "zz-TR"
Request Body schema: application/json
string or Translation (any) (Translation)
One of
string

Responses

Request samples

Content type
application/json
{
  • "input": {
    },
  • "action": {
    }
}

/api/custom-phrases/:languageTag

path Parameters
languageTag
required
string
Enum: "af-ZA" "am-ET" "ar-AR" "as-IN" "az-AZ" "be-BY" "bg-BG" "bn-IN" "br-FR" "bs-BA" "ca-ES" "cb-IQ" "co-FR" "cs-CZ" "cx-PH" "cy-GB" "da-DK" "de" "de-DE" "el-GR" "en" "en-GB" "en-US" "eo-EO" "es" "es-ES" "es-419" "et-EE" "eu-ES" "fa-IR" "ff-NG" "fi-FI" "fo-FO" "fr" "fr-CA" "fr-FR" "fy-NL" "ga-IE" "gl-ES" "gn-PY" "gu-IN" "ha-NG" "he-IL" "hi-IN" "hr-HR" "ht-HT" "hu-HU" "hy-AM" "id-ID" "ik-US" "is-IS" "it" "it-IT" "iu-CA" "ja" "ja-JP" "ja-KS" "jv-ID" "ka-GE" "kk-KZ" "km-KH" "kn-IN" "ko" "ko-KR" "ku-TR" "ky-KG" "lo-LA" "lt-LT" "lv-LV" "mg-MG" "mk-MK" "ml-IN" "mn-MN" "mr-IN" "ms-MY" "mt-MT" "my-MM" "nb-NO" "ne-NP" "nl-BE" "nl-NL" "nn-NO" "or-IN" "pa-IN" "pl-PL" "ps-AF" "pt" "pt-BR" "pt-PT" "ro-RO" "ru" "ru-RU" "rw-RW" "sc-IT" "si-LK" "sk-SK" "sl-SI" "sn-ZW" "sq-AL" "sr-RS" "sv-SE" "sw-KE" "sy-SY" "sz-PL" "ta-IN" "te-IN" "tg-TJ" "th-TH" "tl-PH" "tr" "tr-TR" "tt-RU" "tz-MA" "uk-UA" "ur-PK" "uz-UZ" "vi-VN" "zh" "zh-CN" "zh-HK" "zh-MO" "zh-TW" "zz-TR"

Responses

Hooks

/api/hooks

Responses

/api/hooks

Request Body schema: application/json
tenantId
string <= 21 characters
event
required
string
Enum: "PostRegister" "PostSignIn" "PostResetPassword"
required
object
createdAt
number

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "event": "PostRegister",
  • "config": {
    },
  • "createdAt": 0
}

/api/hooks/:id

path Parameters
id
required
string non-empty

Responses

/api/hooks/:id

path Parameters
id
required
string non-empty
Request Body schema: application/json
tenantId
string <= 21 characters
event
string
Enum: "PostRegister" "PostSignIn" "PostResetPassword"
object
createdAt
number

Responses

Request samples

Content type
application/json
{
  • "tenantId": "string",
  • "event": "PostRegister",
  • "config": {
    },
  • "createdAt": 0
}

/api/hooks/:id

path Parameters
id
required
string non-empty

Responses

Verification Codes

/api/verification-codes

Request Body schema: application/json
One of
email
required
string <regex> /^\[email protected]\S+\.\S+$/

Responses

Request samples

Content type
application/json
{
  • "phone": "/regex/"
}

/api/verification-codes/verify

Request Body schema: application/json
One of
email
required
string <regex> /^\[email protected]\S+\.\S+$/
verificationCode
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "phone": "/regex/",
  • "verificationCode": "string"
}

User Assets

/api/user-assets/service-status

Responses

/api/user-assets

Responses

.well-known

/api/.well-known/sign-in-exp

Responses

/api/.well-known/phrases

query Parameters
lng
string

Responses

Status

/api/status

Responses

Authn

/api/authn/hasura

query Parameters
resource
required
string non-empty
unauthorizedRole
string

Responses

/api/authn/saml/:connectorId

path Parameters
connectorId
required
string non-empty
Request Body schema: application/json
object

arbitrary

Responses

Request samples

Content type
application/json
{ }

Swagger.json

/api/swagger.json

Responses