---
title: "Activate"
method: POST
path: "/api/v1/auth/activate"
tags: ["grandline-auth"]
---

# Activate

`POST /api/v1/auth/activate`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/v1/auth/activate`
- Auth: none declared

First-login verification. The caller proves they received the emailed key
by presenting it; we stamp the account verified. Idempotent — re-activating
an already-verified account just returns its state.

## Response `200`

Successful Response

- ActivateResponse
  - `email` string, required
  - `name` string, nullable, required
  - `status` string, required
  - `verified_at` string, date-time, nullable, required

## Other responses

- `401`: Authentication required
- `404`: Key not found / not owned by caller

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)
