Create a new subject token.

POST /api/subject-tokens
O auth2

Create a new subject token for the use of impersonating the user.

application/json

Body Required

  • userId string Required

    The ID of the user to impersonate.

  • context object

    The additional context to be included in the token, this can be used in custom JWT.

Responses

  • 201 application/json

    The subject token has been created successfully.

    Hide response attributes Show response attributes object
    • subjectToken string Required
    • expiresIn number Required
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    The user does not exist.

POST /api/subject-tokens 
curl \
 --request POST 'https://[tenant_id].logto.app/api/subject-tokens' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"userId":"string","context":{}}'
Request examples 
{
  "userId": "string",
  "context": {}
}
Response examples (201) 
{
  "subjectToken": "string",
  "expiresIn": 42.0
}