Content Service API
  • Getting Started
    • Quickstart
  • API
    • Posts
    • Assets
    • Tags
    • Feed
Powered by GitBook
On this page
  1. API

Assets

PreviousPostsNextTags

Last updated 7 months ago

Delete an asset by ID

delete

Deletes an asset associated with a post. The service handles the underlying logic to ensure proper deletion based on whether the asset belongs to a public or private post.

Path parameters
assetIdstring · uuidrequired
Example: 550e8400-e29b-41d4-a716-446655440000
Responses
cURL
JavaScript
Python
HTTP
curl -L \
  --request DELETE \
  --url '/assets/{assetId}'
204
404
No body

No Content - Asset successfully deleted

  • POSTAttach an image asset to a post
  • POSTAttach a video asset to a post
  • POSTRearrange the order of assets
  • DELETEDelete an asset by ID

Attach an image asset to a post

post

Attaches an image asset to a post. The service determines under the hood whether the asset is attached to a public or private post based on the post type.

Body
postIdstring · uuidoptional
Example: 550e8400-e29b-41d4-a716-446655440000
imageFilestring · binaryoptional

The image file to attach

Responses
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url '/assets/attach-image' \
  --header 'Content-Type: multipart/form-data' \
  --form 'postId=550e8400-e29b-41d4-a716-446655440000' \
  --form 'imageFile=binary'
200
404
{
  "assetId": "550e8400-e29b-41d4-a716-446655440000",
  "postId": "550e8400-e29b-41d4-a716-446655440000",
  "assetType": "IMAGE",
  "url": "https://cdn.example.com/assets/image.jpg",
  "orderIndex": 1,
  "created_at": "2025-04-03T05:37:13.315Z",
  "updated_at": "2025-04-03T05:37:13.315Z"
}

Image asset successfully attached

Attach a video asset to a post

post

Attaches a video asset to a post. The service determines under the hood whether the asset is attached to a public or private post based on the post type.

Body
postIdstring · uuidoptional
Example: 550e8400-e29b-41d4-a716-446655440000
videoFilestring · binaryoptional

The video file to attach

Responses
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url '/assets/attach-video' \
  --header 'Content-Type: multipart/form-data' \
  --form 'postId=550e8400-e29b-41d4-a716-446655440000' \
  --form 'videoFile=binary'
200
404
{
  "assetId": "550e8400-e29b-41d4-a716-446655440000",
  "postId": "550e8400-e29b-41d4-a716-446655440000",
  "assetType": "IMAGE",
  "url": "https://cdn.example.com/assets/image.jpg",
  "orderIndex": 1,
  "created_at": "2025-04-03T05:37:13.315Z",
  "updated_at": "2025-04-03T05:37:13.315Z"
}

Video asset successfully attached

Rearrange the order of assets

post

Rearranges the order of assets attached to a post by taking an ordered array of asset IDs and updating the orderIndex property of each asset accordingly.

Body
assetOrderstring · uuid[]optional

An ordered array of asset IDs

Example: 550e8400-e29b-41d4-a716-446655440000
Responses
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url '/assets/rearrange' \
  --header 'Content-Type: application/json' \
  --data '{
    "assetOrder": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }'
200
404
No body

Assets successfully rearranged