Starts signing in with a provider and says where to send the person
POST
/api/v1/auth/begin - Sign-in
- No scope
- Scope
- None
- MCP tool
identity.beginSignIn
Parameters
None.
Request body
| Field | Type and meaning |
|---|---|
provider required | string One of discord / microsoft / github / google. |
surface | string site or workspace. Left out it is the site. |
Response 200
| Field | Type and meaning |
|---|---|
state always | string Hand this back when they return. |
url always | string Where to send the person to sign in. |
Errors
| Status | Type and meaning |
|---|---|
400 | The request was not understood. |
401 | Sign in and try again. |
404 | There is nothing here, or nothing you may see. |
429 | Too many requests. |
500 | Something on our side went wrong. |
Every error comes back as { code, message, requestId }. Errors