Minctrl Docs

Otp Verify

POST
/auth/otp/verify

Validate the code, then create/login the user. Returns a JWT.

On verify success:

  • If user with this email exists → log in (issue token)
  • If shadow user (status='pending') → claim it, no new company, caller is expected to follow up with /invitations/{token}/accept
  • If brand-new email → create user + auto-company + owner membership

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/auth/otp/verify" \  -H "Content-Type: application/json" \  -d '{    "email": "string",    "code": "string"  }'
null
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}