---
title: "Validate the API key and return its organization"
method: GET
path: "/api/v1/me"
tags: ["Connection"]
---

# Validate the API key and return its organization

`GET /api/v1/me`

## Request

- Base URL: `https://api.agendaforge.app`
- URL: `https://api.agendaforge.app/api/v1/me`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Auth test / connection label. Returns the organization the key is scoped to. Use this to verify a key before configuring an integration.

## Response `200`

The organization the key is scoped to.

- object
  - `orgId` string, required: Opaque organization id.
  - `orgName` string, required: Display name of the organization.

## Other responses

- `401`: The API key is missing, malformed, invalid, expired, or revoked.
- `403`: The API key is valid but does not include the public_api scope. Create a key with the public_api scope in Settings > API Tokens.
- `404`: No such endpoint under /api/v1. The message lists the valid endpoints.
- `429`: The fixed window for this API key (120 requests per minute) or IP (30 per minute, unauthenticated) is exhausted. Wait Retry-After seconds and retry.
- `500`: An unexpected server failure. The body still follows the JSON error contract; retry with exponential backoff.
- `default`: Any other failure, including 404 NOT_FOUND for an unknown path and transient 5xx errors. Always the same JSON error contract.

---

[API](https://skmtc.dev/agendaforge/apis/agendaforge-public-rest-api.md) · [All operations](https://skmtc.dev/agendaforge/apis/agendaforge-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agendaforge/apis/agendaforge-public-rest-api/revisions/b8956ce1e5f3?raw)