---
title: "Microsoft Authorize"
method: GET
path: "/auth/microsoft/authorize"
tags: ["Auth"]
---

# Microsoft Authorize

`GET /auth/microsoft/authorize`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/auth/microsoft/authorize`
- Auth: none declared

Get Microsoft OAuth authorization URL for sign-in.
Frontend should redirect user to this URL.

Args:
    return_to: Optional URL path to return to after authentication
    app: Which app is signing in; Microsoft returns to that app's callback page

## Query parameters

- `return_to` string
- `app` 'dashboard' | 'portal'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `e419e063b238`: 1 info
  - added the new optional `query` request parameter `app`

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/auth/microsoft/authorize/get.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)