Social API reference

Social API · Assets

get/v1/communities/{community_id}/assets/{asset_id}Auth

Fetch one asset with freshly-minted presigned rendition URLs.

Path parameters

community_id*string

Community UUID.

asset_id*string · uuid

Id of the asset.

Response · 200 The asset.

id*string · uuid

Id of the asset.

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

community_id*string · uuid

Id of the community the asset belongs to.

Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"

owner_actor_id*string · uuid

The actor that uploaded the asset (only they can attach it).

Example: "aaaaaaaa-0000-0000-0000-000000000001"

kind*object

`image` or `video`.

Example: "image"

status*object

Videos: uploading → processing → ready | failed. Images never enter 'uploading'.

Example: "ready"

content_type*string

MIME type of the original upload.

Example: "image/jpeg"

byte_size*number

Size of the original upload in bytes.

Example: 512000

width*number

Width of the original in pixels; null until a video is probed.

Example: 3024

height*number

Height of the original in pixels; null until a video is probed.

Example: 4032

duration_s*number

Output duration in seconds — ready videos only.

Example: 12.48

failure_reason*string

Stable code when status='failed' — ASSET_TOO_LARGE, ASSET_INVALID_CONTAINER, ASSET_DURATION_EXCEEDED, ASSET_TRANSCODE_FAILED, ASSET_PROCESSING_FAILED.

Example: null

renditions*array

The sizes you can display, each with a short-lived URL. Empty until the asset is `ready`.

created_at*string · date-time

When the asset was created.

Example: "2026-05-01T12:00:00.000Z"

updated_at*string · date-time

When the asset last changed (status or renditions).

Example: "2026-05-01T12:00:00.000Z"

Example

Request

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

Response

{
  "id": "eeeeeeee-0000-0000-0000-000000000001",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "owner_actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "kind": "image",
  "status": "ready",
  "content_type": "image/jpeg",
  "byte_size": 512000,
  "width": 3024,
  "height": 4032,
  "duration_s": 12.48,
  "failure_reason": null,
  "renditions": [
    {
      "name": "medium",
      "url": "https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…",
      "content_type": "image/jpeg",
      "width": 1280,
      "height": 960,
      "byte_size": 184320
    }
  ],
  "created_at": "2026-05-01T12:00:00.000Z",
  "updated_at": "2026-05-01T12:00:00.000Z"
}