---
title: "Check Agent Link Slug Endpoint"
method: GET
path: "/api/v1/agent-links/check-slug/{slug}"
tags: ["agent-links"]
---

# Check Agent Link Slug Endpoint

`GET /api/v1/agent-links/check-slug/{slug}`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/agent-links/check-slug/{slug}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Check whether an agent-link slug is globally available (auth required).

Slugs are globally unique, so availability is not account-scoped; the auth
dependency gates access without the handler needing the user object. Route
declared before ``GET /{link_id}`` so the literal prefix wins over the int.

## Path parameters

- `slug` string, required

## Response `200`

Successful Response

- AgentLinkSlugAvailability: Availability result for an agent-link slug (globally unique).
  - `available` boolean, required
  - `reason` string, nullable

## Other responses

- `422`: Validation Error

---

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