Register Publication
POST /api/v1/collab-scenes/{sceneId}/publications: register a content URL after greenlight.
SHA-256 is required. Compute the digest of the exact file you published and pass it as depictionSha256. That hash is what satisfies 28 CFR 75.2(f) record integrity.
If you did not create the scene, call POST /extend first. Without it this endpoint returns 403 with code extension_required.
Authorization
BearerAuth 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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
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/publications" \ -H "Content-Type: application/json" \ -d '{ "contentUrl": "https://your-platform.com/post/12345", "depictionSha256": "a3f5b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1" }'{
"id": "cmd5rc1v90007qz8h4p8w2n6y",
"collabSceneId": "cmd5r9a4t0001qz8hb6k2m3xd",
"contentUrl": "http://example.com",
"publishedAt": "2019-08-24T14:15:22Z"
}{
"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": "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"
}