# temp.md Public API

**Canonical:** https://apis.io/apis/temp-md/tempmd-public-api/  
**Provider:** temp.md — https://apis.io/providers/temp-md/  
**Base URL:** https://api.temp.md  
**Documentation:** https://temp.md/docs

temp.md Public API is one of 4 APIs that [temp.md](https://apis.io/providers/temp-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Web Publishing, Static Hosting, AI Agents, and Agent-Native. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and rate-limit docs.

Publish agent-made files and applications to one canonical URL, update them atomically, and recover owner credentials without changing the shared link. 23 operations across Publish (multipart create/update and the idempotent, resumable publish-session protocol), Lifecycle (status, restore within 7 days of expiry, snapshot, settings, permanent revoke), Comments, Accounts (signup, login, named API keys, update-token recovery), Safety (abuse reports) and Agents (A2A card + JSON-RPC). Capability-token auth; anonymous publishing allowed.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/agent-card.json` | Discover the A2A 1.0 agent |
| POST | `/a2a` | Send an A2A 1.0 JSON-RPC request |
| GET | `/health` | Check API health |
| POST | `/temps` | Publish a small multipart bundle |
| PUT | `/temps/{tempId}` | Replace a Temp with a new multipart Version |
| DELETE | `/temps/{tempId}` | Permanently revoke a Temp and delete its artifacts |
| POST | `/publish-sessions` | Create or resume an idempotent upload session |
| GET | `/publish-sessions/{sessionId}` | Resume a publish session |
| PUT | `/publish-sessions/{sessionId}/files/{fileId}` | Upload one declared file |
| POST | `/publish-sessions/{sessionId}/finalize` | Verify and atomically promote a Version |
| GET | `/temps/{tempId}/status` | Read lifecycle and access status |
| POST | `/temps/{tempId}/restore` | Restore an expired Temp within its restore window |
| POST | `/temps/{tempId}/snapshot` | Freeze the current Version |
| PATCH | `/temps/{tempId}/settings` | Update Temp settings |
| GET | `/temps/{tempId}/comments` | List visible comments |
| POST | `/temps/{tempId}/comments` | Append validated visitor comments |
| POST | `/auth/signup` | Create an account |
| POST | `/auth/login` | Create an account session |
| GET | `/me/api-keys` | List named API keys without secrets |
| POST | `/me/api-keys` | Create a named API key |
| DELETE | `/me/api-keys/{keyId}` | Revoke an API key immediately |
| POST | `/me/temps/{tempId}/update-token` | Recover a lost scoped update token |
| POST | `/abuse-reports` | Report unsafe content |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/openapi/temp-md-openapi.yml
- **OpenAPI** — https://temp.md/openapi.json
- **Documentation** — https://temp.md/docs
- **APIReference** — https://temp.md/docs#response
- **GettingStarted** — https://temp.md/docs#overview
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/overlays/temp-md-openapi-overlay.yaml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/errors/temp-md-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/data-model/temp-md-data-model.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/conventions/temp-md-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/conventions/temp-md-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/rate-limits/temp-md-rate-limits.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/temp-md/refs/heads/main/apis.yml

## Other temp.md APIs (3)

- [temp.md Embedded Preview Platform API](https://apis.io/apis/temp-md/tempmd-embedded-preview-platform-api/)
- [temp.md MCP Server](https://apis.io/apis/temp-md/tempmd-mcp-server/)
- [temp.md A2A Publisher Agent](https://apis.io/apis/temp-md/tempmd-a2a-publisher-agent/)

## Tags

Web Publishing, Static Hosting, AI Agents, Agent-Native

---

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