새 예약을 만들고 원래 예약을 취소하는 일을 한 번의 요청으로 합니다.

curl -X POST "https://example.com/api/v1/scheduled-posts/55555555-5555-4555-8555-555555555555/replace?platform=threads" \  -H "Content-Type: application/json" \  -d '{    "accountIds": [      "11111111-1111-4111-8111-111111111111"    ],    "posts": [      "Updated launch announcement"    ],    "scheduledAt": "2026-10-02T09:00:00+09:00",    "timezone": "Asia/Seoul"  }'

{  "results": [    {      "accountId": "11111111-1111-4111-8111-111111111111",      "provider": "threads",      "username": "your_brand",      "success": true,      "scheduledPostIds": [        "77777777-7777-4777-8777-777777777777"      ],      "scheduledAt": "2026-10-02T09:00:00+09:00"    }  ],  "summary": {    "succeeded": 1,    "failed": 0  },  "replaced": {    "scheduledPostId": "55555555-5555-4555-8555-555555555555",    "platform": "threads",    "canceled": 1  }}

예약 하나를 새 예약으로 한 번의 요청에 바꿉니다. Posteady는 새 예약을 먼저 만들고, 새 예약이 접수된 뒤에만 원래 예약을 취소합니다. 그래서 요청이 실패해도 그 시간대가 비지 않습니다. 본문은 예약 만들기와 같으며 accountIds는 원래 예약의 계정 하나여야 합니다. 새 예약은 새 scheduledPostIds를 받습니다. 새 예약이 실패하면 원래 예약은 그대로이고 replaced는 null입니다. 원래 예약이 취소되기 전에 발행을 시작하면 Posteady는 새 예약을 취소하고 POST_NOT_CANCELLABLE(409)을 반환합니다. 발행을 시작하지 않은 예약만 바꿀 수 있습니다. API로 접수한 Instagram·Facebook 예약은 내용·미디어·계정이 고정되므로, 이를 바꾸려면 교체하세요. 요청 시간이 초과되면 다시 보내기 전에 예약 목록을 확인하세요.

인증

apiKey

인증Bearer <token>

위치: header

경로 매개변수

id*string

형식uuid

쿼리 매개변수

platform*string

허용값

"threads"
"x"
"linkedin"
"tiktok"
"instagram"
"youtube"
"facebook"

요청 본문

application/json

TypeScript 타입

TypeScript에서 request body 타입을 사용하세요.

Threads, X, LinkedIn에는 텍스트를 발행합니다. 공개 TikTok 동영상 하나에는 video, Instagram 미디어 게시물 하나에는 instagram, YouTube 동영상 하나에는 youtube, Facebook 페이지 게시물 하나에는 facebook을 사용합니다. TikTok은 posts와 video를 함께 사용합니다. Instagram, YouTube, Facebook은 각각 독립된 발행 형식으로 다른 발행 형식과 함께 보낼 수 없습니다. Threads 텍스트 요청에는 mediaIds 를 더해 첫 글에 라이브러리 이미지를 붙일 수 있습니다.

accountIds?array<>

텍스트 대상 계정은 1~5개입니다. TikTok, Instagram, YouTube, Facebook 미디어 발행은 계정 하나만 지정하세요.

항목1 <= items <= 5

posts*array<>

연속된 텍스트 글입니다. video가 있으면 비어 있지 않은 캡션 하나만 허용합니다. TikTok 캡션은 UTF-16 코드 단위 기준 최대 2,200자입니다. LinkedIn도 글 하나만 허용합니다. X는 발행하거나 예약을 저장하기 전에 posts[0]에서 링크를 자동 제거합니다. http://, https://, www.와 foo.com, foo.io/path처럼 프로토콜 없는 도메인이 대상이며 경로·쿼리 문자열·프래그먼트도 함께 제거합니다. 답글인 posts[1] 이후의 링크와 다른 플랫폼의 원문은 유지합니다. X 글자 수는 제거 후 검증합니다. 첫 글에 빈 문자열이나 공백만 남으면 발행·예약 전에 요청 전체가 VALIDATION_ERROR(HTTP 422)로 실패합니다.

항목1 <= items <= 25

mediaIds?array<>

Threads 전용입니다. 미디어 라이브러리에서 확인을 마친 이미지 mediaId(GET /api/v1/media, mediaType=IMAGE)를 posts[0]에 붙입니다. 이미지 하나는 이미지 게시물, 2~20개는 캐러셀로 발행됩니다. posts[1] 이후 답글은 텍스트 그대로입니다. accountIds 의 모든 계정이 Threads 계정이어야 하며 video, instagram, youtube, facebook 과 함께 보낼 수 없습니다.

항목1 <= items <= 20

video?

같은 워크스페이스의 활성 미디어 라이브러리에서 동영상 하나를 TikTok for Business Developers로 연결한 계정 하나에 발행합니다. 새 업로드는 확인을 마친 뒤 mediaId를 사용하세요. 사진 발행과 임의 동영상 URL은 지원하지 않습니다. accountIds에 계정 하나, posts에 캡션 하나를 지정해야 합니다.

instagram?||

Instagram 프로페셔널 계정 하나에 발행합니다. 아래 콘텐츠 유형 중 정확히 하나를 선택하고 posts나 video와 함께 보내지 마세요.

youtube?

같은 워크스페이스의 활성 미디어 라이브러리에서 동영상 하나를 연결된 YouTube 채널 하나에 발행합니다. 새 업로드는 확인을 마친 뒤 mediaId를 사용하세요. 동영상은 최대 500 MiB, 12시간입니다. accountIds에 계정 하나만 지정하고 posts, video, instagram은 함께 보내지 마세요. 첫 댓글은 지원하지 않습니다.

facebook?|||

Facebook 페이지 하나에 비동기로 발행합니다. 콘텐츠 유형을 정확히 하나 지정하고 posts, video, instagram, youtube와 함께 보내지 마세요. requestId는 워크스페이스 내 고유 값이며 입력이 동일한 요청에만 재사용하세요.

scheduledAt*string

시간대 오프셋이 포함된 미래 ISO 8601 시각입니다. 현재부터 360일 이내여야 합니다. 예제 시각을 실제 발행할 미래 시각으로 바꾸세요.

형식date-time

timezone?string

IANA 시간대입니다. 예: Asia/Seoul. 생략하면 워크스페이스 기본값을 사용하며 기본값이 없으면 UTC를 사용합니다.

예약 교체

인증

경로 매개변수

쿼리 매개변수

요청 본문

응답 본문

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

예약 교체

인증

경로 매개변수

쿼리 매개변수

요청 본문

응답 본문

200application/json

202application/json

404application/json

409application/json

422application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`