Synapse 적재 API로 작업기록 남기기

Starter 이상 요금제의 조직에서 쓸 수 있습니다.

API 키가 있으면 어디서든 HTTP 요청으로 작업기록을 남길 수 있습니다. 키는 관리자가 관리 콘솔 › 보안 › API 키에서 발급합니다. 키의 권한은 키 주인의 권한을 따릅니다. 키 값은 다른 사람에게 보이지 않게 보관하세요.

기록 남기기

curl -X POST https://arcgroup.kr/api/synapse/ingest \
  -H "x-synapse-key: <발급받은 API 키>" \
  -H "Content-Type: application/json" \
  -d '{"title":"적재 테스트","body":"API 적재가 되는지 확인","project":"테스트","work_type":"docs","tags":["test"]}'
칸뜻
title한 줄 요약 (필수)
body맥락·원인·시도·결과
project프로젝트 경로 — 계층은 슬래시(서비스/모듈/세부)
work_typefeature · bugfix · infra · research · meeting · decision · ops · docs
tags태그 목록

응답 201이면 성공, 401은 키 오류, 400은 제목이 없을 때입니다.

남기기 전에 프로젝트 구조 확인

같은 뜻의 프로젝트가 여러 이름으로 생기지 않도록, 먼저 지금 구조를 확인하고 있는 경로를 그대로 씁니다.

curl https://arcgroup.kr/api/synapse/projects/tree -H "x-synapse-key: <발급받은 API 키>"

응답의 projects에 경로(path)와 기록 수가 들어 있습니다.

고치기와 지우기

  • 찾기: GET https://arcgroup.kr/api/synapse/work-logs?q=검색어
  • 고치기: PATCH https://arcgroup.kr/api/synapse/work-logs/<id> (바꿀 칸만 보냅니다)
  • 지우기: DELETE https://arcgroup.kr/api/synapse/work-logs/<id>

모두 같은 x-synapse-key 머리글을 씁니다.

AI 도구에 지침으로 주기

AI 코딩 도구에 「Synapse에 기록해 줘라고 하면 위 형식으로 남겨라」는 지침을 주면, 작업이 끝날 때마다 기록을 남기게 할 수 있습니다. Claude라면 Claude에서 ARC 쓰기처럼 직접 연결하는 편이 더 간단합니다.

도움이 되었나요?

도움이 더 필요하신가요?

ARC AI가 도움말을 찾아 답해 드립니다. 해결되지 않으면 문의해 주세요.

문의하기

관련 도움말