Social API reference

Social API · Assets

post/v1/communities/{community_id}/assets/{asset_id}/completeAuth

Finalize a presigned-PUT video upload. Verifies the stored object (existence, size, container magic bytes) and enqueues the transcode. Replaying on a finalized asset returns its current status without re-enqueueing.

Path parameters

community_id*string

Community UUID.

asset_id*string

Video asset UUID (status `uploading`).

Headers

Idempotency-Keystring

Makes retries safe.

Response · 200 Finalized (`processing`) — or the current status on replay.

id*string · uuid

Id of the new asset; attach it to posts, comments or messages once it is `ready`.

Example: "eeeeeeee-0000-0000-0000-000000000001"

status*object

`ready` when the bytes were sent inline; `uploading` until you PUT the bytes to `upload.url` (then call complete); `processing` while a video transcodes; `failed` on error.

Example: "ready"

uploadobject

Present only on video creation — PUT the bytes here, then POST /assets/:id/complete.

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/assets/{asset_id}/complete
Authorization: Bearer YOUR_TOKEN

Response

{
  "id": "eeeeeeee-0000-0000-0000-000000000001",
  "status": "ready",
  "upload": {}
}