Create an upload session

Creates a new upload session for a hide (conceal) or reveal (extract) job. Returns the upload_uid you must include in every TUS upload request for this session. Authentication: X-Api-Key header required.

post/api/session

Request

Base URL: https://snapwonders.com
URL: https://snapwonders.com/api/session
Auth: API key in header X-Api-Key

Request body

type'hide' | 'reveal' required

hide to conceal content inside a cover image; reveal to extract hidden content from a stego image.

Example request

{
  "type": "hide"
}

Response

Session created

upload_uidstring uuid

UUID to include in every TUS upload for this session

type'hide' | 'reveal'

statusstring

created_atstring date-time

tus_endpointstring

TUS root endpoint — append the upload ID for PATCH/HEAD requests

instructionsobject

Step-by-step upload instructions. Each key is a step name; value describes what to upload and which TUS metadata to set.

Example response

{
  "upload_uid": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "tus_endpoint": "/api/tus"
}

Changes

No recorded changes to this operation across all 1 revision of this API.