Easy2257
API Reference

Extend to Your Platform

POST /api/v1/collab-scenes/{sceneId}/extend: sign once, publish everywhere.

Sign once, publish everywhere. Once every performer has signed on one platform, the uploader can syndicate the scene to any other Easy2257 partner platform without a second signing round: the model releases already cover multi-platform distribution. Each platform then registers its own publication URL and gets its own acquirer reports.

No request body. Authorization is the sceneId itself, which the scene's creating partner shares with you when the syndication is arranged. Extending charges your partner account $2 (200 cents, USD), off-session against your partner owner user's saved payment method, at most once per partner per scene. The extension is recorded even if that charge fails: check fee.charged in the response, and re-POST to retry an unpaid fee without being charged twice.

POST
/api/v1/collab-scenes/{sceneId}/extend

Authorization

BearerAuth
AuthorizationBearer <token>

Partner API key from partner.easy2257.com/api-keys. Only ez_live_ keys are accepted. A key beginning with ez_test_ is rejected with 403 and code TEST_MODE_UNAVAILABLE before any handler runs: there is no sandbox, and every handler writes production records, provisions real users, and sends real email. New partner accounts start with a test key, so create a live key before your first call.

In: header

Path Parameters

sceneId*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://easy2257.com/api/v1/collab-scenes/cmd5r9a4t0001qz8hb6k2m3xd/extend"
{
  "sceneId": "cmd5r9a4t0001qz8hb6k2m3xd",
  "status": "greenlit",
  "extendedTo": "cmd2n6t0h0001qz8h1c9x4b7m",
  "performerCount": 3,
  "consentedCount": 3,
  "releaseSignedCount": 3,
  "fee": {
    "extensionFeeCents": 200,
    "charged": true,
    "stripeChargeId": "pi_3NabcDEfghIJklmn",
    "chargeError": null
  },
  "nextStep": "Call POST /api/v1/collab-scenes/{sceneId}/publications with your content URL and depiction SHA-256."
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "Too many requests. Please slow down.",
  "retryAfter": 14,
  "limit": 60,
  "remaining": 0,
  "reset": 1714000060000
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}