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

Parameter	Type	Required	Description
scheduleId	string	Yes	The unique identifier of the scheduled post.

Request Body

Field	Type	Required	Description
title	string	Yes	Title of the content (used for YouTube and as the Pinterest pin title, etc.).
description	string	Yes	Caption or description of the post.
topic	string	Yes	Topic for Threads.
type	string	Yes	Content type to post. Options: text, image, video, reel, album, link, story.
medias	array	Yes	Array of media objects to attach (images/videos).
meta	object	Yes	Link metadata for link-type posts.
additionalInfo	object	Yes	Additional configuration for the post.
additionalInfo.isAiGenerated	boolean	No	Whether content is AI-generated.
additionalInfo.isDraft	boolean	No	Whether to save as draft.
additionalInfo.isAutoAddMusic	boolean	No	Whether to automatically add music to post.
additionalInfo.isShareToFeed	boolean	No	Whether to share Reel to Instagram profile grid/feed (applies to Instagram Reels).
additionalInfo.collaborators	array	No	Instagram collaborator usernames.
additionalInfo.mentions	array	No	Usernames to mention (Instagram Story only).
additionalInfo.music	object	No	TikTok music attachment with volume controls (see below).
additionalInfo.products	array	No	Shopee product attachments.
additionalInfo.tags	array	No	YouTube tags for discoverability.
additionalInfo.targetCountries	array	No	Target country codes for audience targeting.
additionalInfo.channel	object	No	WhatsApp or Telegram channel or group, or Pinterest board, to post to (see below). Leave out to post to the WhatsApp Status or Telegram Story. Required for Pinterest.
additionalInfo.link	string	No	Pinterest only: the destination URL the pin opens when someone taps it.
replies	array	Yes	Nested replies for thread-style posts (Threads and X).
scheduleAt	string	Yes	ISO 8601 datetime for the scheduled publish time.
templateId	string	No	ID of the automation template to attach to this post.

Music Object (additionalInfo.music)

Field	Type	Required	Description
id	string	Yes	The TikTok music track ID.
artist	string	Yes	Artist name.
name	string	Yes	Music track name.
thumbnail	string	Yes	Track thumbnail image URL.
volume	object	Yes	Volume adjustment settings for the original video and music track.
volume.video	number	Yes	Original video audio volume percentage (e.g. 50).
volume.music	number	Yes	Background music track volume percentage (e.g. 100).

Channel Object (additionalInfo.channel)

WhatsApp, Telegram, and Pinterest only. Send one item from Get WhatsApp Channel, Get Telegram Channel, or Get Pinterest Board as it is returned:

Field	Type	Required	Description
id	string	Yes	Channel, group, or board ID. On WhatsApp, its suffix decides where the post goes: @newsletter for a Channel, @g.us for a group.
name	string	Yes	Channel, group, or board name.
picture	string	Yes	Channel, group, or board picture: a URL on WhatsApp and Pinterest, a data: URI on Telegram (can be empty).
type	string	Yes	channel or group, or board for a Pinterest board. On Telegram, this decides where the post goes, because channel and supergroup IDs look the same.

Send the whole additionalInfo again

Update replaces additionalInfo as a whole. If you leave channel out, a WhatsApp or Telegram schedule that was going to a channel or group goes to the number's Status or the account's Story instead. A Pinterest schedule needs its board in channel every time, and its link too if it has one.

Example Request

cURL

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,"isShareToFeed":false,"collaborators":[],"mentions":[],"music":{"id":"","artist":"","name":"","thumbnail":"","volume":{"video":50,"music":100}},"products":[],"tags":[],"targetCountries":[]},"replies":[],"scheduleAt":"2026-05-30T09:01:26.510Z"}'

Axios

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,
      isShareToFeed: 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);

Fetch

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,
        isShareToFeed: 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

204

// No content returned on success

404

{
  "code": 404,
  "message": "schedule not found"
}

401

{
  "code": 401,
  "message": "unauthorized"
}