Skip to content

Update Schedule

PUT /public/schedule/{scheduleId}

Update the content, scheduled time, or configuration of an existing scheduled post.

Endpoint Details

  • Authentication: Basic Auth (Authorization: Basic Base64(AccessKey:SecretKey))
  • Access Tier: Premium+

Parameters

ParameterTypeRequiredDescription
scheduleIdstringYesThe unique identifier of the scheduled post.

Request Body

FieldTypeRequiredDescription
titlestringYesTitle of the content (used for YouTube, etc.).
descriptionstringYesCaption or description of the post.
topicstringYesTopic for Threads.
typestringYesContent type to post. Options: text, image, video, reel, album, link, story.
mediasarrayYesArray of media objects to attach (images/videos).
metaobjectYesLink metadata for link-type posts.
additionalInfoobjectYesAdditional configuration for the post.
additionalInfo.isAiGeneratedbooleanNoWhether content is AI-generated.
additionalInfo.isDraftbooleanNoWhether to save as draft.
additionalInfo.isAutoAddMusicbooleanNoWhether to automatically add music to post.
additionalInfo.collaboratorsarrayNoInstagram collaborator usernames.
additionalInfo.mentionsarrayNoUsernames to mention (Instagram Story only).
additionalInfo.musicobjectNoTikTok music attachment with volume controls (see below).
additionalInfo.productsarrayNoShopee product attachments.
additionalInfo.tagsarrayNoYouTube tags for discoverability.
additionalInfo.targetCountriesarrayNoTarget country codes for audience targeting.
repliesarrayYesNested replies for thread-style posts (Threads platform).
scheduleAtstringYesISO 8601 datetime for the scheduled publish time.
templateIdstringNoID of the automation template to attach to this post.

Music Object (additionalInfo.music)

FieldTypeRequiredDescription
idstringYesThe TikTok music track ID.
artiststringYesArtist name.
namestringYesMusic track name.
thumbnailstringYesTrack thumbnail image URL.
volumeobjectYesVolume adjustment settings for the original video and music track.
volume.videonumberYesOriginal video audio volume percentage (e.g. 50).
volume.musicnumberYesBackground music track volume percentage (e.g. 100).

Example Request

bash
curl -X PUT "https://api.repliz.com/public/schedule/680affa5ce12f2f72916f67e" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{"title":"Baju Baru","description":"Baju baru alhamdulillah","topic":"Fashion","type":"text","medias":[],"meta":{"title":"","description":"","url":"","thumbnail":""},"additionalInfo":{"isAiGenerated":false,"isDraft":false,"isAutoAddMusic":false,"collaborators":[],"mentions":[],"music":{"id":"","artist":"","name":"","thumbnail":"","volume":{"video":50,"music":100}},"products":[],"tags":[],"targetCountries":[]},"replies":[],"scheduleAt":"2026-05-30T09:01:26.510Z"}'
javascript
import axios from 'axios';

const scheduleId = '680affa5ce12f2f72916f67e';

const response = await axios.put(
  `https://api.repliz.com/public/schedule/${scheduleId}`,
  {
    title: 'Baju Baru',
    description: 'Baju baru alhamdulillah',
    topic: 'Fashion',
    type: 'text',
    medias: [],
    meta: {
      title: '',
      description: '',
      url: '',
      thumbnail: '',
    },
    additionalInfo: {
      isAiGenerated: false,
      isDraft: false,
      isAutoAddMusic: false,
      collaborators: [],
      mentions: [],
      music: {
        id: '',
        artist: '',
        name: '',
        thumbnail: '',
        volume: { video: 50, music: 100 },
      },
      products: [],
      tags: [],
      targetCountries: [],
    },
    replies: [],
    scheduleAt: '2026-05-30T09:01:26.510Z',
  },
  {
    auth: {
      username: 'YOUR_ACCESS_KEY',
      password: 'YOUR_SECRET_KEY',
    },
  },
);

console.log(response.data);
javascript
const credentials = btoa('YOUR_ACCESS_KEY:YOUR_SECRET_KEY');

const scheduleId = '680affa5ce12f2f72916f67e';

const response = await fetch(
  `https://api.repliz.com/public/schedule/${scheduleId}`,
  {
    method: 'PUT',
    headers: {
      Authorization: `Basic ${credentials}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      title: 'Baju Baru',
      description: 'Baju baru alhamdulillah',
      topic: 'Fashion',
      type: 'text',
      medias: [],
      meta: {
        title: '',
        description: '',
        url: '',
        thumbnail: '',
      },
      additionalInfo: {
        isAiGenerated: false,
        isDraft: false,
        isAutoAddMusic: false,
        collaborators: [],
        mentions: [],
        music: {
          id: '',
          artist: '',
          name: '',
          thumbnail: '',
          volume: { video: 50, music: 100 },
        },
        products: [],
        tags: [],
        targetCountries: [],
      },
      replies: [],
      scheduleAt: '2026-05-30T09:01:26.510Z',
    }),
  },
);

const data = await response.json();
console.log(data);

Response

json
// No content returned on success
json
{
  "code": 404,
  "message": "schedule not found"
}
json
{
  "code": 401,
  "message": "unauthorized"
}