38 lines
1.4 KiB
YAML
38 lines
1.4 KiB
YAML
post:
|
|
tags: [Verification, Auth]
|
|
summary: Request verification code
|
|
description: |
|
|
Creates a verification challenge for the specified purpose/target.
|
|
For `purpose=login`, request must be authorized with a pending account token.
|
|
operationId: verificationRequestCode
|
|
security:
|
|
- bearerAuth: []
|
|
requestBody:
|
|
$ref: ./bodies/verification.yaml#/components/requestBodies/VerificationCodeBody
|
|
responses:
|
|
'202':
|
|
description: Verification code requested
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: ../response/response.yaml#/components/schemas/BaseResponse
|
|
- type: object
|
|
properties:
|
|
data:
|
|
$ref: ./response/verification.yaml#/components/schemas/VerificationResponseData
|
|
'400':
|
|
$ref: ../response/operation.yaml#/components/responses/BadRequest
|
|
'401':
|
|
$ref: ../response/operation.yaml#/components/responses/Unauthorized
|
|
'403':
|
|
$ref: ../response/operation.yaml#/components/responses/Forbidden
|
|
'404':
|
|
$ref: ../response/operation.yaml#/components/responses/NotFound
|
|
'409':
|
|
$ref: ../response/operation.yaml#/components/responses/Conflict
|
|
'429':
|
|
$ref: ../response/operation.yaml#/components/responses/TooManyRequests
|
|
'500':
|
|
$ref: ../response/operation.yaml#/components/responses/InternalServerError
|