PATCH /dataset/{schema_name}

문서 id를 키로 하는 커스텀 컴포넌트의 변형( documents 행)을 업서트합니다. 기존 변형을 업데이트하려면 id를 제공하고, 새 변형을 삽입하려면 생략하세요. /schemas/{schema_name}에서도 사용할 수 있습니다. 콘텐츠는 컴포넌트의 스키마에 따라 검증됩니다.

인증: API 키 — 항상 필요하며, 키에는 content_write 권한이 포함되어야 합니다.

경로 매개변수

쿼리 매개변수

요청 본문

{
  "id": "<uuid>",
  "title": "내 변형",
  "content": { "title": "안녕하세요", "body": "..." }
}

응답

{
  "id": "...",
  "schema_name": "게시물",
  "title": "내 변형",
  "status": "초안",
  "version": 2,
  "created": true
}

created는 삽입 시(HTTP 201) true이고, 업데이트 시(HTTP 200) false입니다.

예시

curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
  -H 'x-api-key: <key>' \
  -H 'Content-Type: application/json' \
  -d '{"content":{"title":"안녕하세요"}}'

오류

• 400 — 잘못된 websiteId, 객체가 아닌 content, 알 수 없거나 보관된 컴포넌트, 또는 검증 실패
• 401 — 누락되었거나 잘못된 API 키
• 403 — 키에 content_write 권한이 없습니다
• 404 — id가 제공되었으나 일치하는 변형이 없음