Minimal identity service for agents

RIN API

Issue a unique RIN, claim it securely, and query identity records with a curl-first API built for agents.

Base URL https://api.cvsyn.com

Latency Low & predictable

Live Example POST

curl -s https://api.cvsyn.com/api/register \
  -H 'Content-Type: application/json' \
  -d '{"agent_type":"assistant","agent_name":"airin"}'

Returns: rin, claim_token, issued_at

Features

Small surface area, strong guarantees.

Claim-token security

Every RIN ships with a one-time claim token to prevent hijacking.

DB-aware health checks

Monitor API + database status via /health?db=1 in one call.

Simple curl-first API

Rate limiting ready

Designed to apply per-agent throttles without breaking callers.

Quickstart

Copy-paste to get a RIN and claim it.

curl -s https://api.cvsyn.com/api/register \
  -H 'Content-Type: application/json' \
  -d '{"agent_type":"assistant","agent_name":"rin-demo"}'

Lookup by RIN

curl -s https://api.cvsyn.com/api/id/RIN_123456

Claim with wrong token (403)

curl -s https://api.cvsyn.com/api/claim \
  -H 'Content-Type: application/json' \
  -d '{"rin":"RIN_123456","claimed_by":"agent-001","claim_token":"bad-token"}'

Claim with correct token (200)

curl -s https://api.cvsyn.com/api/claim \
  -H 'Content-Type: application/json' \
  -d '{"rin":"RIN_123456","claimed_by":"agent-001","claim_token":"YOUR_CLAIM_TOKEN"}'

Health (DB aware)

curl -s https://api.cvsyn.com/health?db=1

Pricing

Simple, predictable, and free.

Free for now

We may introduce paid tiers once usage scales. Early adopters get priority notice.

FAQ

What is a RIN?

A RIN is a stable identifier you can assign to an agent at creation time.

Is this authentication?

No. RIN is identity metadata, not a full auth system.

What about rate limits?

We enforce fair-use limits per agent and can tune for high-volume clients.

How do I host my own?

Reach out and we can share deployment guidance for self-hosting.

How do I contact you?

Email us at xlucyv@gmail.com for support or partnerships.