# Browser authentication action

`GET /api/auth/{path}`

Browser authentication for the hosted application. Use the Wildmail sign-in and security screens to manage sessions and second-factor challenges. Server integrations use scoped API keys. The path parameter can contain multiple segments. This wildcard is not a literal endpoint.

Send API requests to your Wildmail application origin. The documentation host does not serve API requests.

## Authentication

No authentication scheme is required by this operation.

Audience: auth.

## Parameters

### path

path parameter; required.

```json
{
  "name": "path",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

## Responses

### 200

Library-defined response: JSON, redirect or session-cookie update according to the selected auth endpoint. Schema intentionally unspecified.

### 400

Authentication validation error.

### 401

Authentication required.

### 403

Origin or authorization denied.

### 429

Authentication rate limit. Shared request limiting can also return 429 rate_limit_exceeded with Retry-After (seconds) and Cache-Control: no-store.

Headers:

```json
{
  "Cache-Control": {
    "description": "Request limiter responses use no-store.",
    "schema": {
      "type": "string"
    }
  },
  "Retry-After": {
    "description": "Seconds to wait before retrying a throttled authentication request.",
    "schema": {
      "type": "integer",
      "minimum": 1
    }
  }
}
```

Content type: `application/json`.

Schema:

```json
{
  "anyOf": [
    {
      "$ref": "#/components/schemas/RequestLimitError"
    },
    {
      "type": "object",
      "description": "Authentication error returned by the selected sign-in action."
    }
  ]
}
```

### 503



## Referenced schemas

References resolve against the [OpenAPI specification](/openapi.json).

### #/components/schemas/RequestLimitError

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "enum": [
        "rate_limit_exceeded",
        "rate_limit_unavailable"
      ]
    }
  },
  "required": [
    "error",
    "code"
  ]
}
```
