Update Storyboard Elements

curl --request PUT \
  --url https://api.pictory.ai/pictoryapis/v2/storyboard/YOUR_JOB_ID/elements \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "id": "backgroundElement_20260306230202544742ecd40c041449dac21bb737c799201",
      "elementType": "backgroundElement",
      "type": "video",
      "startTime": 0,
      "duration": 7.6,
      "url": "https://your-cdn.com/new-background.mp4",
      "visualUrl": "https://your-cdn.com/new-background.mp4",
      "visualType": "video"
    }
  ]'

// Get the element ID from the preview response renderParams.elements
const elementId = renderParams.elements.find(
  el => el.elementType === 'backgroundElement' && el.startTime === 0
).id;

const response = await fetch(
  `https://api.pictory.ai/pictoryapis/v2/storyboard/${jobId}/elements`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([
      {
        id: elementId,
        elementType: 'backgroundElement',
        type: 'video',
        startTime: 0,
        duration: 7.6,
        url: 'https://your-cdn.com/new-background.mp4',
        visualUrl: 'https://your-cdn.com/new-background.mp4',
        visualType: 'video'
      }
    ])
  }
);

if (response.status === 204) {
  console.log('Background visual updated successfully');
}

import requests

# Get the element ID from the preview response renderParams.elements
element_id = next(
    el['id'] for el in render_params['elements']
    if el['elementType'] == 'backgroundElement' and el['startTime'] == 0
)

response = requests.put(
    f'https://api.pictory.ai/pictoryapis/v2/storyboard/{job_id}/elements',
    headers={
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=[
        {
            'id': element_id,
            'elementType': 'backgroundElement',
            'type': 'video',
            'startTime': 0,
            'duration': 7.6,
            'url': 'https://your-cdn.com/new-background.mp4',
            'visualUrl': 'https://your-cdn.com/new-background.mp4',
            'visualType': 'video'
        }
    ]
)

if response.status_code == 204:
    print('Background visual updated successfully')

<?php

$jobId = 'YOUR_JOB_ID';
// Use the element ID from the preview response renderParams.elements
$elementId = 'backgroundElement_20260306230202544742ecd40c041449dac21bb737c799201';
$url = "https://api.pictory.ai/pictoryapis/v2/storyboard/{$jobId}/elements";

$payload = [
    [
        'id' => $elementId,
        'elementType' => 'backgroundElement',
        'type' => 'video',
        'startTime' => 0,
        'duration' => 7.6,
        'url' => 'https://your-cdn.com/new-background.mp4',
        'visualUrl' => 'https://your-cdn.com/new-background.mp4',
        'visualType' => 'video'
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 204) {
    echo "Background visual updated successfully\n";
}
?>

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    jobID := "YOUR_JOB_ID"
    // Use the element ID from the preview response renderParams.elements
    elementID := "backgroundElement_20260306230202544742ecd40c041449dac21bb737c799201"
    url := fmt.Sprintf("https://api.pictory.ai/pictoryapis/v2/storyboard/%s/elements", jobID)

    payload := []map[string]interface{}{
        {
            "id":          elementID,
            "elementType": "backgroundElement",
            "type":        "video",
            "startTime":   0,
            "duration":    7.6,
            "url":         "https://your-cdn.com/new-background.mp4",
            "visualUrl":   "https://your-cdn.com/new-background.mp4",
            "visualType":  "video",
        },
    }

    requestBody, _ := json.Marshal(payload)

    req, err := http.NewRequest("PUT", url, bytes.NewBuffer(requestBody))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode == 204 {
        fmt.Println("Background visual updated successfully")
    }
}

// Find the scene text element to update
const sceneTextElement = renderParams.elements.find(
  el => el.elementType === 'SceneText' && el.startTime === 7.6
);

const response = await fetch(
  `https://api.pictory.ai/pictoryapis/v2/storyboard/${jobId}/elements`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([
      {
        id: sceneTextElement.id,
        elementType: 'SceneText',
        type: 'text',
        startTime: sceneTextElement.startTime,
        duration: sceneTextElement.duration,
        text: 'By <strong>automating</strong> repetitive <strong>tasks</strong>, AI frees up time for <strong>creative work</strong> and <strong>strategic thinking</strong>.',
        textLines: [] // Clear textLines so line breaks are recalculated
      }
    ])
  }
);

if (response.status === 204) {
  console.log('Scene text updated successfully');
}

import requests

# Find the scene text element to update
scene_text = next(
    el for el in render_params['elements']
    if el['elementType'] == 'SceneText' and el['startTime'] == 7.6
)

response = requests.put(
    f'https://api.pictory.ai/pictoryapis/v2/storyboard/{job_id}/elements',
    headers={
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=[
        {
            'id': scene_text['id'],
            'elementType': 'SceneText',
            'type': 'text',
            'startTime': scene_text['startTime'],
            'duration': scene_text['duration'],
            'text': 'By <strong>automating</strong> repetitive <strong>tasks</strong>, AI frees up time for <strong>creative work</strong> and <strong>strategic thinking</strong>.',
            'textLines': []  # Clear textLines so line breaks are recalculated
        }
    ]
)

if response.status_code == 204:
    print('Scene text updated successfully')

const response = await fetch(
  `https://api.pictory.ai/pictoryapis/v2/storyboard/${jobId}/elements`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([
      {
        id: 'bgMusic',
        elementType: 'audioElement',
        type: 'audio',
        startTime: 0,
        duration: 100000,
        url: 'https://your-cdn.com/new-background-music.mp3'
      }
    ])
  }
);

if (response.status === 204) {
  console.log('Background music updated successfully');
}

import requests

response = requests.put(
    f'https://api.pictory.ai/pictoryapis/v2/storyboard/{job_id}/elements',
    headers={
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=[
        {
            'id': 'bgMusic',
            'elementType': 'audioElement',
            'type': 'audio',
            'startTime': 0,
            'duration': 100000,
            'url': 'https://your-cdn.com/new-background-music.mp3'
        }
    ]
)

if response.status_code == 204:
    print('Background music updated successfully')

// Update background visuals, scene text, and music in a single request
const elements = renderParams.elements;

// Find elements by type
const bg1 = elements.find(el => el.elementType === 'backgroundElement' && el.startTime === 0);
const bg2 = elements.find(el => el.elementType === 'backgroundElement' && el.startTime === 7.6);
const sceneText = elements.find(el => el.elementType === 'SceneText' && el.startTime === 7.6);

const response = await fetch(
  `https://api.pictory.ai/pictoryapis/v2/storyboard/${jobId}/elements`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([
      // Replace scene 1 background with a custom image
      {
        id: bg1.id,
        elementType: 'backgroundElement',
        type: 'image',
        startTime: 0,
        duration: 7.6,
        url: 'https://your-cdn.com/intro-background.jpg',
        visualUrl: 'https://your-cdn.com/intro-background.jpg',
        visualType: 'image'
      },
      // Replace scene 2 background with a custom video
      {
        id: bg2.id,
        elementType: 'backgroundElement',
        type: 'video',
        startTime: 7.6,
        duration: 11.1,
        url: 'https://your-cdn.com/demo-footage.mp4',
        visualUrl: 'https://your-cdn.com/demo-footage.mp4',
        visualType: 'video'
      },
      // Update scene text: set textLines to null so line breaks are recalculated
      {
        id: sceneText.id,
        elementType: 'SceneText',
        type: 'text',
        startTime: 7.6,
        duration: 11.1,
        text: 'Updated scene text with <strong>highlighted keywords</strong> for emphasis.',
        textLines: []
      },
      // Replace background music
      {
        id: 'bgMusic',
        elementType: 'audioElement',
        type: 'audio',
        startTime: 0,
        duration: 100000,
        url: 'https://your-cdn.com/corporate-music.mp3'
      }
    ])
  }
);

if (response.status === 204) {
  console.log('All elements updated successfully');
}

import requests

elements = render_params['elements']

# Find elements by type
bg1 = next(el for el in elements if el['elementType'] == 'backgroundElement' and el['startTime'] == 0)
bg2 = next(el for el in elements if el['elementType'] == 'backgroundElement' and el['startTime'] == 7.6)
scene_text = next(el for el in elements if el['elementType'] == 'SceneText' and el['startTime'] == 7.6)

response = requests.put(
    f'https://api.pictory.ai/pictoryapis/v2/storyboard/{job_id}/elements',
    headers={
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=[
        # Replace scene 1 background with a custom image
        {
            'id': bg1['id'],
            'elementType': 'backgroundElement',
            'type': 'image',
            'startTime': 0,
            'duration': 7.6,
            'url': 'https://your-cdn.com/intro-background.jpg',
            'visualUrl': 'https://your-cdn.com/intro-background.jpg',
            'visualType': 'image'
        },
        # Replace scene 2 background with a custom video
        {
            'id': bg2['id'],
            'elementType': 'backgroundElement',
            'type': 'video',
            'startTime': 7.6,
            'duration': 11.1,
            'url': 'https://your-cdn.com/demo-footage.mp4',
            'visualUrl': 'https://your-cdn.com/demo-footage.mp4',
            'visualType': 'video'
        },
        # Update scene text: set textLines to None so line breaks are recalculated
        {
            'id': scene_text['id'],
            'elementType': 'SceneText',
            'type': 'text',
            'startTime': 7.6,
            'duration': 11.1,
            'text': 'Updated scene text with <strong>highlighted keywords</strong> for emphasis.',
            'textLines': None
        },
        # Replace background music
        {
            'id': 'bgMusic',
            'elementType': 'audioElement',
            'type': 'audio',
            'startTime': 0,
            'duration': 100000,
            'url': 'https://your-cdn.com/corporate-music.mp3'
        }
    ]
)

if response.status_code == 204:
    print('All elements updated successfully')