Hosted Attestation

Start a hosted attestation session

Hands the whole attestation step to Easy2257. You post the content facts, redirect the uploader to hostedUrl, and Easy2257 renders the form, captures the producer attestation with IP, user agent and timestamp, and tells you when it is done. Your platform builds no compliance UI. detectedFaceCount chooses the path: 1 records a solo attestation and fires upload_session.solo_completed; 2 or more opens a collab scene from the collaborators the uploader names, emails them, and fires collab_scene.created carrying uploadSessionId so you can correlate it back to the content row. The uploader must already have an active solo account under your partner account. Sessions last 24 hours, and each call creates a new one.

post/api/v1/upload-sessions

Request

  • Base URL: https://easy2257.com
  • URL: https://easy2257.com/api/v1/upload-sessions
  • Auth: HTTP bearer

Request body

contentIdstring required

Your content id. Echoed back to you on the completion webhook so you can find the row again.

contentType'image' | 'video' | 'gallery' required
contentTitlestring required
detectedFaceCountinteger required

How many people your pipeline detected in the upload. This alone chooses the path: 1 collects a solo attestation, 2 or more opens a collab scene and emails every collaborator the uploader names.

uploaderExternalUserIdstring required

Your user id for the uploader. Must already map to an active Easy2257 solo account under your partner account.

uploaderEmailstring email required
uploaderFirstNamestring
uploaderLastNamestring
callbackUrlstring uri required

Required, stored for your reference. Events go to your portal-registered endpoints.

redirectUrlstring uri required

Required. Where the hosted form returns the uploader when they are done.

Example request

{
  "contentId": "video_abc123",
  "contentTitle": "April 2026 Scene",
  "detectedFaceCount": 2,
  "uploaderExternalUserId": "user_12345",
  "uploaderEmail": "creator@example.com",
  "callbackUrl": "https://your-platform.com/webhooks/ez2257",
  "redirectUrl": "https://your-platform.com/uploads/video_abc123"
}

Response

Session created. Redirect the uploader to hostedUrl.

sessionIdstring required
tokenstring required

64-character session token. Treat it as a secret: anyone holding it can complete the attestation.

hostedUrlstring uri required

Send the uploader here in top-level navigation. Easy2257 hosts the attestation form, so you build no compliance UI at all.

status'created' required
expiresAtstring date-time required

24 hours from creation. After that the uploader needs a new session.

Example response

{
  "sessionId": "cmd6t2p5x0001qz8h7f3d9k4w",
  "token": "3f9c1d...",
  "hostedUrl": "https://easy2257.com/upload-attestation/3f9c1d...",
  "expiresAt": "2026-04-25T18:00:00Z"
}

Changes

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