# snapwonders-com Reveal API

**Canonical:** https://apis.io/apis/snapwonders-com/snapwonders-com-reveal-api/  
**Provider:** snapwonders-com — https://apis.io/providers/snapwonders-com/  
**Base URL:** https://snapwonders.com  
**Documentation:** https://snapwonders.com/api

snapwonders-com Reveal API is one of 8 APIs that [snapwonders-com](https://apis.io/providers/snapwonders-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Reveal. The published artifact set on APIs.io includes an OpenAPI specification.

**Extract hidden content from a stego image.** Requires the same password used when the content was originally hidden. All endpoints require `X-Api-Key`. **Workflow — 6 steps:** **Step 1 — Create a session** `POST /api/session` · body: `{"type":"reveal"}` Returns `upload_uid` — include it in every upload for this session. **Step 2 — Upload the stego image** `POST /api/upload` · headers `X-Upload-Uid`, `X-Filename`, `Content-Type`, file as the body. This is the carrier image that contains the hidden content. Large files or unreliable connections: TUS `POST /api/tus` with `Upload-Metadata: upload_uid <b64(uid)>,step MQ==`, `POST` to create then `PATCH` the raw binary. **Step 3 — Verify the upload is complete** `GET /api/session/{uid}/files` The file must show `"status":"completed"` before proceeding. **Step 4 — Start the extraction job** `POST /api/job` · Required: `upload_uid`, `password`, `expiry` Encoding options (`output_format`, etc.) are accepted but ignored for reveal jobs. Returns `{"status":"queued", ...}`. **Step 5 — Poll until done** `GET /api/job/{uid}` — repeat every few seconds. Watch `status`: `queued` → `processing` → `completed` (or `partial` / `failed`). **Step 6 — Download the extracted content** `GET /api/job/{uid}/results` Returns `result_files` with a `download_url` for each file that was extracted from the stego image.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/session` | Create an upload session |
| GET | `/api/session/{uid}/files` | List uploaded files for a session |
| POST | `/api/job` | Start a processing job |
| GET | `/api/job/{uid}` | Get job status |
| GET | `/api/job/{uid}/results` | Get job result files |
| GET | `/api/job/download/{assetId}` | Download a hide/reveal result file |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/snapwonders-com/openapi/snapwonders-com-reveal-api-openapi.yml

## Other snapwonders-com APIs (7)

- [snapwonders-com Analyse API](https://apis.io/apis/snapwonders-com/snapwonders-com-analyse-api/)
- [snapwonders-com Convert API](https://apis.io/apis/snapwonders-com/snapwonders-com-convert-api/)
- [snapwonders-com Hide API](https://apis.io/apis/snapwonders-com/snapwonders-com-hide-api/)
- [snapwonders-com MCP API](https://apis.io/apis/snapwonders-com/snapwonders-com-mcp-api/)
- [snapwonders-com Media Upload - Direct API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-direct-api/)
- [snapwonders-com Media Upload - TUS Resumable API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-tus-resumable-api/)
- [snapwonders-com Status API](https://apis.io/apis/snapwonders-com/snapwonders-com-status-api/)

## Tags

Reveal

---

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