---
title: "Save Ahrefs API key"
method: POST
path: "/api/v1/ahrefs/connection"
tags: ["Ahrefs"]
---

# Save Ahrefs API key

`POST /api/v1/ahrefs/connection`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/ahrefs/connection`
- Auth: `BearerAuth` (a scheme the document does not define)

Saves the user's Ahrefs API key. The key is stored per-user in Azure Key Vault (cloud) or local .tokens/ directory (dev). Each API call to Ahrefs consumes units from the user's monthly quota (min 50 units/request).

## Request body

- AhrefsConnectionRequest
  - `api_key` string, required: Your Ahrefs API key (from app.ahrefs.com → Account settings → API keys)

## Response `200`

Credentials saved

- AhrefsConnectionStatus
  - `configured` boolean
  - `connector_id` string
  - `api_key_set` boolean
  - `updated_at` number, nullable

## Other responses

- `400`: Validation error (missing or empty api_key)
- `401`: Unauthorized

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)