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_type | feature · 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 쓰기처럼 직접 연결하는 편이 더 간단합니다.