Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB
Communities::Spaces::Post::VideoEmbed

Create Video Embed

Attach a video embed to a post. The url field is required.

post/communities/spaces/posts/{post_id}/video_embeds

Path parameters

post_idinteger required

Request body

Example request

{
  "communities_spaces_posts_video_embed": {
    "communities_spaces_posts_video_embed": {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "provider": "youtube"
    }
  }
}

Response

Created

idinteger

Video Embed ID

public_idstring nullable

Video Embed public ID

post_idinteger

ID of the Post the video is attached to

provider'youtube' | 'vimeo' | 'loom' | 'voomly' nullable

Video provider name, auto-detected from the URL. One of youtube, vimeo, loom, voomly.

urlstring nullable

Source URL of the video

dataobject nullable

Provider-specific metadata (arbitrary key/value pairs)

workspace_idinteger nullable

Workspace ID the post belongs to

created_atstring date-time nullable

Created at

updated_atstring date-time nullable

Updated at

Example response

{
  "id": 501,
  "public_id": "EfGhIj",
  "post_id": 101,
  "provider": "youtube",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "duration": 212
  },
  "workspace_id": 42,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}