プレイリストに項目を追加（管理者用）

POST/manage/playlists/:playlistId/items

プレイリストに 4S のイベントまたは外部リンクを追加します。kind で種別を指定し、kind=FOUR_S_EVENT なら eventId、kind=EXTERNAL_LINK なら sourceUrl と title を指定します。表示順は末尾に自動で割り当てられます。

認証	要ログイン

パスパラメータ

playlistIdstring必須

プレイリスト ID または slug。

リクエストボディ

kindstring必須

FOUR_S_EVENT（4S のイベント）または EXTERNAL_LINK（外部イベント）。

eventIdstring任意

kind=FOUR_S_EVENT のとき必須。公開中（PUBLISHED）のイベントのみ追加できる。

sourceUrlstring任意

kind=EXTERNAL_LINK のとき必須。外部イベントの URL（https のみ）。

titlestring任意

kind=EXTERNAL_LINK のとき必須。イベント名。kind=FOUR_S_EVENT ではイベント側の値を使う。

description / imageUrl / schedules / location / organizerNamemixed任意

kind=EXTERNAL_LINK の付加情報。

tagsstring[]任意

タグ名の配列。

レスポンス

PlaylistItem を返します。

リクエスト

curl https://api.4s.link/manage/playlists/PLAYLIST_ID/items \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "FOUR_S_EVENT",
  "eventId": "e1f2a3b4-..."
}'

レスポンス例

{
  "id": "pi1a2b3-...",
  "title": "4S Tech Conference 2026",
  "type": "EVENT",
  "eventId": "e1f2a3b4-...",
  "externalUrl": null,
  "thumbnailUrl": "https://.../thumb.png",
  "order": 0
}