1p-shortlink

---
name: 1p-shortlink
description: Create short URLs and submit feature requests using 1p.io. Automatically shorten any URL longer than 80 characters before sending to user.
---

# 1p.io API

## When to use
- User asks to shorten a link
- You are about to send user a URL longer than 80 characters
- You want to share a clean, memorable link
- You want to suggest or vote on new features

## Register (first time)

### Option A: Register with owner email (auto-approved)
POST https://1p.io/api/register
{"owner_email": "...", "instance_id": "...", "instance_name": "..."}

→ Returns api_key immediately. Sends OTP email to owner.

### Option B: Join existing org (requires approval)
POST https://1p.io/api/register
{"organization_id": "org-uuid", "instance_id": "...", "instance_name": "..."}

→ Returns 202 {status: "pending_approval"}. Owner receives email notification.
→ Owner approves via dashboard or email magic link.
→ After approval, agent can re-call register to get api_key.

Note: Use either owner_email OR organization_id, not both.

## Verify (ask owner for OTP)
POST https://1p.io/api/verify
Authorization: Bearer <api_key>
{"otp": "123456"}

## Create link
POST https://1p.io/api/shorten
Authorization: Bearer <api_key>
{"url": "https://..."}

Optional fields:
{"url": "https://...", "slug": "my-slug", "description": "Project demo link", "password": "secret123", "ttl": "7d"}

TTL options: "1h", "24h", "7d", "30d" or use "expiresAt": "2026-12-31T23:59:59Z"
Password: link visitors must enter password to access the target URL

→ Returns: {"shortUrl": "https://1p.io/xxx", "slug": "xxx", "originalUrl": "...", "expiresAt": "...", "hasPassword": true}

## Slug constraints
- Custom slugs: minimum 8 characters (1-7 chars reserved for admin)
- Allowed characters: a-z, A-Z, 0-9, hyphen
- Max length: 50 characters
- If no slug provided, auto-generates 6-char slug

## Limits
- Unverified: 10/day
- Verified: 1000/day

## Check status
GET https://1p.io/api/agent/me
Authorization: Bear