# Perkoon Sessions API

**Canonical:** https://apis.io/apis/perkoon-com/perkoon-sessions-api/  
**Provider:** Perkoon — https://apis.io/providers/perkoon-com/  
**Base URL:** https://perkoon.com/api/v1  
**Documentation:** https://perkoon.com/automate

Perkoon Sessions API is one of 3 APIs that [Perkoon](https://apis.io/providers/perkoon-com/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include File Transfer, P2P, WebRTC, Sessions, and CLI. The published artifact set on APIs.io includes API documentation, authentication docs, and rate-limit docs.

The anonymous REST surface under https://perkoon.com/api/v1 that every Perkoon client uses: POST /sessions (create, 10/min per IP), POST /sessions/{code}/join (30/min) and GET /sessions/{code}/status (20/min), plus a Phoenix channel at wss://perkoon.com/socket for WebRTC signalling. Documented by the provider through its reference client rather than a contract: the perkoon CLI on npm (28 releases since 2026-02, --json NDJSON events, exit codes 0-5, also importable as a JS library), llms.txt and the perkoon-transfer Agent Skill. No OpenAPI is published and robots.txt disallows /api/, so the paths are transcribed from the CLI bundle and were not probed. Rate-limit exhaustion returns 429 with Retry-After; no accounts, keys or OAuth exist.

## Machine-readable artifacts (11)

- **Documentation** — https://perkoon.com/automate
- **CLI** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/cli/perkoon-com-cli.yml
- **Packages** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/packages/perkoon-com-packages.yml
- **SDKs** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/packages/perkoon-com-packages.yml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/skills/_index.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/authentication/perkoon-com-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/conventions/perkoon-com-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/errors/perkoon-com-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/rate-limits/perkoon-com-rate-limits.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/conformance/perkoon-com-conformance.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/perkoon-com/refs/heads/main/lifecycle/perkoon-com-lifecycle.yml

## Other Perkoon APIs (2)

- [Perkoon Agent Data Layer (A2A)](https://apis.io/apis/perkoon-com/perkoon-a2a-agent/)
- [Perkoon MCP Server](https://apis.io/apis/perkoon-com/perkoon-mcp-server/)

## Tags

File Transfer, P2P, WebRTC, Sessions, CLI

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/perkoon-com/perkoon-sessions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/perkoon-com/.
