AGENTYK — EMAIL HOSTING FOR AI AGENTS

This is a REST API service. There are NO web forms. All interaction is via HTTP requests with JSON.

Base URL: https://agentyk.ru

All requests use Content-Type: application/json

Full machine-readable spec: https://agentyk.ru/.well-known/agent.json

HOW TO GET AN EMAIL ACCOUNT — 3 STEPS

STEP 1: REGISTER (no auth required)

POST https://agentyk.ru/register
Content-Type: application/json
Body: {"username": "myagent"}

Response:
{
  "email": "myagent@agentyk.ru",
  "temp_password": "xxxxxxxx",
  "api_key": "ayk_xxxxxxxxxxxx",
  "recovery_seed": "word1 word2 word3 ... word12",
  "invoice_id": "INV-xxxxxxxxxxxx",
  "btc_wallet": "bc1xxxxxxxxxxxx",
  "amount_btc": "0.00123",
  "qr_code": "(unicode QR code for terminal display)",
  "status": "pending_payment"
}

IMPORTANT: Save api_key and recovery_seed immediately. The recovery_seed is shown ONLY ONCE.

Your account is CREATED but INACTIVE. You cannot send or receive email until you pay.

STEP 2: PAY TO ACTIVATE (no auth required)

Option A — Bitcoin:
Send exactly amount_btc to btc_wallet.
Monitor payment:
GET https://agentyk.ru/register/status/{invoice_id}
Response when paid: {"status": "settled"}

Option B — Coupon (instant activation):
POST https://agentyk.ru/register/redeem
Content-Type: application/json
Body: {"invoice_id": "INV-xxxxxxxxxxxx", "coupon": "AYK-XXXX-XXXX-XXXX"}

STEP 3: USE YOUR EMAIL (requires X-API-Key header)

Send an email:
POST https://agentyk.ru/mail/send
X-API-Key: ayk_xxxxxxxxxxxx
Content-Type: application/json
Body: {"to": "someone@example.com", "subject": "Hello", "body": "Message text"}

Read inbox:
GET https://agentyk.ru/mail
X-API-Key: ayk_xxxxxxxxxxxx
Returns: [{id, from, to, subject, date, size}]

Read one email:
GET https://agentyk.ru/mail/{id}
X-API-Key: ayk_xxxxxxxxxxxx
Returns: {id, from, to, subject, body, date, attachments}

COMPLETE API REFERENCE

PUBLIC ENDPOINTS (no authentication)

• POST /register — Body: {"username":"name"} — Create account
• GET /register/status/{invoice_id} — Check payment status
• POST /register/redeem — Body: {"invoice_id":"INV-xxx","coupon":"AYK-XXXX-XXXX-XXXX"} — Activate with coupon
• POST /login/request-reset — Body: {"email":"you@agentyk.ru"} — Send reset link
• POST /login/reset — Body: {"token":"xxx","new_password":"NewPass123!"}
• POST /login/recover/seed — Body: {"email":"...","seed":"12 words","new_password":"..."}
• POST /login/recover/invoice — Body: {"email":"...","invoice_id":"INV-xxx","new_password":"..."}
• GET /health — Returns: {"status":"ok"}
• GET /.well-known/agent.json — Full API spec

EMAIL ENDPOINTS (require X-API-Key header)

• GET /mail — List messages. Params: ?folder, ?search, ?from, ?to, ?subject, ?since, ?before
• GET /mail/{id} — Read message with attachments list
• GET /mail/attachment/{blobId} — Download attachment binary
• POST /mail/send — Body: {"to":"...","subject":"...","body":"...","attachments":[{"filename":"...","content":"base64","type":"mime/type"}]}
• POST /mail/{id}/forward — Forward a message
• DELETE /mail/{id} — Delete a message

ACCOUNT ENDPOINTS (require X-API-Key header)

• GET /account/status — Returns: {email, status, expires_at, quota_used, created_at}
• POST /account/change-password — Body: {"new_password":"..."} — Min 8 chars, 1 upper, 1 number, 1 special
• GET /account/whitelist — Returns: {enabled, emails[]}
• POST /account/whitelist — Body: {"enabled":true,"emails":["trusted@example.com","*@domain.com"]}
• POST /account/encryption — Body: {"pgp_public_key":"-----BEGIN PGP PUBLIC KEY BLOCK-----\n..."}
• DELETE /account/encryption — Disable encryption at rest

MANAGEMENT ENDPOINTS (require email + password in JSON body)

All require: {"email":"you@agentyk.ru","password":"YourPass123!"}

• POST /login — Returns all account data (this IS your data export)
• POST /login/change-password — Additional: "new_password"
• POST /login/recovery-email — Additional: "recovery_email"
• POST /login/forward — Additional: "forward_email" (empty to disable)
• POST /login/extend — Returns BTC payment info for renewal
• POST /login/extend/redeem — Additional: "coupon"
• POST /login/delete — Additional: "confirm":"DELETE" — PERMANENT, irreversible

DOWNLOAD ALL YOUR DATA

1. POST /login with email+password — returns all account fields
2. GET /account/whitelist with X-API-Key — returns whitelist config
3. GET /mail with X-API-Key — returns all messages
4. GET /mail/{id} for each message — returns full content
5. GET /mail/attachment/{blobId} for each attachment — returns files

That is ALL data we store. There is nothing else.

WHAT WE STORE

• Email address, password hash (bcrypt), API key
• Account status, expiry date, creation date
• Recovery email and forwarding address (only if set)
• Sender whitelist config (only if enabled)
• Invoice ID and payment status
• Your emails (encrypted at rest if PGP key uploaded)

WHAT WE DO NOT STORE

• Real names, phone numbers, IP addresses
• Browser fingerprints, cookies, tracking data
• Payment card or bank details
• Analytics or telemetry

TERMS

• Price: $60 USD/year in Bitcoin or coupon. Non-refundable.
• Mailbox: 500 MB circular buffer.
• No spam, phishing, malware, harassment. Violation = instant termination.
• Service as-is, no uptime guarantee. You keep backups.
• Data disclosed only under valid court order.
• PGP-encrypted mailboxes cannot be decrypted by us.
• Contact: admin@agentyk.ru

ACCOUNT LIFECYCLE

• Active: full access
• -30 days: renewal reminder
• Expiry: read-only (receive, no send)
• +30 days: suspended (no access)
• +60 days: permanently deleted
• Renew anytime before deletion: POST /login/extend or /login/extend/redeem

SERVICE DETAILS

• IMAP: mail.agentyk.ru:993 (implicit TLS)
• SMTP: mail.agentyk.ru:465 (implicit TLS)
• DKIM + SPF + DMARC configured
• GET /health for status check