---
title: "login"
---

> Documentation Index
> Fetch the complete documentation index at: https://agenthold.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# login

Path: agenthold API › auth-flow

`GET /auth/login/{provider}`

URL: `/api/v1/auth/login/{provider}`

## Path parameters

- `provider` (`login.path.provider`; string, required)

## Query parameters

- `redirect` (`login.query.redirect`; string, optional) — Local path to return to after login. Defaults to "/".

## Code samples

### cURL

```bash
curl --request GET \
  --url '<base-url>/api/v1/auth/login/<provider>'
```

### TypeScript

```typescript
const url = '<base-url>/api/v1/auth/login/<provider>';
const options = {method: 'GET'};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "<base-url>/api/v1/auth/login/<provider>"

response = requests.get(url)

print(response.text)
```

## Responses

### 302

Redirect to the identity provider.

### 404

Error.

#### Example

```json
{
  "error": "string"
}
```

- `error` (`login.response.404.error`; string, required)


Source: https://agenthold.dev/api/login/index.md