---
title: "Claim a referral code for your key (attract signups, earn rewards)"
method: POST
path: "/v1/refclaim"
---

# Claim a referral code for your key (attract signups, earn rewards)

`POST /v1/refclaim`

## Request

- Base URL: `https://agent-shield.startekenterprises.com`
- URL: `https://agent-shield.startekenterprises.com/v1/refclaim`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `ref` string, required: Desired code, [a-z0-9_-], max 32 chars

## Response `200`

Code claimed

- object
  - `ok` boolean
  - `ref` string

## Other responses

- `400`: ref required or invalid
- `409`: Code already taken

---

[API](https://skmtc.dev/startekenterprises/apis/agent-shield.md) · [All operations](https://skmtc.dev/startekenterprises/apis/agent-shield/llms.txt) · [OpenAPI document](https://skmtc.dev/startekenterprises/apis/agent-shield/revisions/858e23c6841d?raw)