ARTEX 현재 시스템 문서
전체 문서
이 페이지 목차

Agent·LLM·Tool·관리 API 전수 참조

agent, LLM, tool, MCP, skill, company, intercept와 sync 영역의 등록 operation을 전수 색인한다. 이 페이지는 route/address/auth/handler 요약이고 field-level 계약은 API 의미 schema가 소유한다.

분모 · 이 페이지 82개 / 전체 261개. route 등록·auth·직접 handler는 C다. 요청/응답 semantic은 operation별 C/P/U를 분리하며 route 수를 semantic 완료율로 쓰지 않는다.

Operation 색인

operation handler auth 입력 status schema
GET /api/llm getLLM JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401 P
POST /api/llm setLLM JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500 P
POST /api/llm/test testLLM JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401 P
GET /api/llm/records pgListLLMRecords JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query model,page,session,size,task 200/401/500 P
DELETE /api/llm/records pgDeleteLLMRecords JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query task 200/400/401/500 P
GET /api/llm/records/tasks pgLLMTasks JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500 P
GET /api/llm/records/by-model pgTokenByModel JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query task 200/400/401/500 P
GET /api/llm/records/{id} pgGetLLMRecord JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/400/401/404 P
GET /api/chat/mentions searchChatMentions JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query cursor,kind,q 200/400/401/500/503 P
POST /api/chat chat JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query task; JSON 200/202/400/401/404/409/500 P
POST /api/chat/upload chatUpload JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query id,scope; multipart/form-data 200/400/401/404/409/500 P
GET /api/conversations pgListConversations JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500/503 P
POST /api/conversations pgCreateConversation JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/404/413/500/503 P
POST /api/conversations/delete/batch pgDeleteConversationsBatch JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/413/500/503 P
PATCH /api/conversations/{id} pgRenameConversation JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; JSON 200/400/401/404/413/500/503 P
PATCH /api/conversations/{id}/profile pgUpdateConversation JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; JSON 200/400/401/404/413/500/503 C
DELETE /api/conversations/{id} pgDeleteConversation JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/400/401/404/500/503 P
GET /api/conversations/{id}/messages pgConversationMessages JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; query before,limit,since 200/400/401/404/500/503 P
POST /api/conversations/{id}/messages pgSendConversationMessage JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; JSON 202/400/401/404/409/500/503 C
POST /api/conversations/{id}/stop pgStopConversation JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/400/401/404/500/503 C
GET /api/conversations/{id}/messages/{seq} pgConversationMsgDetail JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id,seq 200/400/401/404/500/503 P
GET /api/agents pgListAgents JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500/503 P
POST /api/agents pgCreateAgent JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/409/500/503 P
GET /api/agents/{key} pgGetAgent JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
PATCH /api/agents/{key} pgUpdateAgent JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 C
DELETE /api/agents/{key} pgDeleteAgent JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/400/401/404/500/503 P
PUT /api/agents/{key}/config pgSaveAgentConfig JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 P
PUT /api/agents/{key}/prompt pgSavePrompt JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 P
POST /api/agents/{key}/prompt/reset pgResetPrompt JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/400/401/404/500/503 P
PUT /api/agents/{key}/wrapup pgSaveWrapup JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 C
POST /api/agents/{key}/wrapup/reset pgResetWrapup JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
PUT /api/agents/{key}/wrapup/task-timeout pgSaveTaskTimeoutWrapup JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 C
POST /api/agents/{key}/wrapup/task-timeout/reset pgResetTaskTimeoutWrapup JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
GET /api/agents/{key}/triggers pgListTriggers JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
POST /api/agents/{key}/triggers pgCreateTrigger JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 P
GET /api/agents/{key}/prompts pgListPromptVersions JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
GET /api/agents/{key}/variables pgPromptVars JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
POST /api/agents/{key}/prompt/preview pgPreviewPrompt JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/401/404/500/503 P
GET /api/agents/{key}/visibility pgGetAgentVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 P
PUT /api/agents/{key}/visibility pgSetAgentVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 C
GET /api/tools pgListTools JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500/503 P
PUT /api/tools/{key} pgUpdateTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/404/500/503 C
POST /api/tools/custom pgCreateCustomTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/409/500/503 P
POST /api/tools/custom/test pgTestCustomTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/503 P
PUT /api/tools/custom/{key} pgUpdateCustomTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key; JSON 200/400/401/500/503 C
DELETE /api/tools/custom/{key} pgDeleteCustomTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/500/503 P
POST /api/tools/{key}/reset pgResetTool JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path key 200/401/404/500/503 C
GET /api/mcp pgListMCP JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500/503 P
POST /api/mcp pgSaveMCP JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 P
DELETE /api/mcp/{id} pgDeleteMCP JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/401/500/503 P
GET /api/mcp/{id}/tools pgMCPTools JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/401/500/503 P
POST /api/mcp/{id}/refresh pgRefreshMCP JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/401/404/500/502/503 P
GET /api/skills fsListSkills JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500 P
POST /api/skills fsCreateSkill JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 201/400/401/409/500 P
POST /api/skills/upload fsUploadSkill JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query overwrite; multipart/form-data 201/400/401/409/500 P
DELETE /api/skills/{name} fsDeleteSkill JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name 200/400/401/500/503 P
GET /api/skills/missing fsMissingSkills JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 query limit 200/401/500/503 P
GET /api/skills/{name}/usage fsSkillUsage JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name; query limit 200/400/401/500/503 P
PUT /api/skills/{name}/meta fsUpdateSkillMeta JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name; JSON 200/400/401/404/500 C
POST /api/skills/{name}/dirs fsCreateDir JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name; JSON 201/400/401/404/500 P
GET /api/skills/{name}/files fsListFiles JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name 200/400/401/404/500 P
GET /api/skills/{name}/files/{file...} fsReadFile JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name,file 200/400/401/404/500 P
PUT /api/skills/{name}/files/{file...} fsWriteFile JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name,file; JSON 200/400/401/404/500 C
DELETE /api/skills/{name}/files/{file...} fsDeletePath JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name,file 200/400/401/404/500 P
GET /api/visibility/{kind}/{id} pgResourceVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path kind,id 200/401/500/503 P
POST /api/visibility/toggle pgToggleVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 C
GET /api/visibility/skill/{name} pgSkillVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path name 200/401/500/503 P
POST /api/visibility/skill/toggle pgToggleSkillVisibility JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 C
GET /api/llm/profiles pgListProfiles JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/500/503 P
POST /api/llm/profiles pgSaveProfile JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 P
DELETE /api/llm/profiles/{id} pgDeleteProfile JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/401/404/409/500/503 P
POST /api/llm/profiles/active pgActivateProfile JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 C
GET /api/llm/retry-policy pgGetLLMRetryPolicy JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/503 P
POST /api/llm/retry-policy pgSaveLLMRetryPolicy JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/500/503 P
GET /api/llm/pool pgLLMPoolStatus JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 none 200/401/503 P
POST /api/llm/pool/reset pgLLMPoolReset JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401/503 P
POST /api/llm/models pgListModels JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 JSON 200/400/401 P
GET /api/conversations/{id}/side-questions handleSideQuestions JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; query before 200/400/401/404/500/503 P
POST /api/conversations/{id}/side-questions handleSideQuestions JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id; JSON 200/202/400/401/404/409/429/500/503 P
DELETE /api/conversations/{id}/side-questions handleSideQuestions JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path id 200/400/401/404/500/503 C
GET /api/side-questions/{requestID}/events sideEvents JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path requestID 200/401/404/500 P
POST /api/side-questions/{requestID}/cancel cancelSideRequest JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택 path requestID 200/401/404/500 C

GET /api/llm

GET /api/llm · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler getLLM · server/server.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/llm

POST /api/llm · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler setLLM · server/server.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/llm/test

POST /api/llm/test · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler testLLM · server/server.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/llm/records

GET /api/llm/records · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListLLMRecords · server/commands.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query model, page, session, size, task · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

DELETE /api/llm/records

DELETE /api/llm/records · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteLLMRecords · server/commands.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query task · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/llm/records/tasks

GET /api/llm/records/tasks · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgLLMTasks · server/commands.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/llm/records/by-model

GET /api/llm/records/by-model · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgTokenByModel · server/commands.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query task · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/llm/records/{id}

GET /api/llm/records/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgGetLLMRecord · server/commands.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/chat/mentions

GET /api/chat/mentions · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler searchChatMentions · server/chat_mentions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query cursor, kind, q · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/chat

POST /api/chat · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler chat · server/server.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query task · body JSON
status/error 직접 관찰 200, 202, 400, 401, 404, 409, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · agent turn을 background context에서 실행할 수 있음; activity/stop/terminal event를 확인

POST /api/chat/upload

POST /api/chat/upload · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 3개

전체 관계 5개 · 종류 선택·관계도
계약 확인 결과
등록·handler chatUpload · server/chatupload.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query id, scope · body multipart/form-data
status/error 직접 관찰 200, 400, 401, 404, 409, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/conversations

GET /api/conversations · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListConversations · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/conversations

POST /api/conversations · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgCreateConversation · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 413, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/conversations/delete/batch

POST /api/conversations/delete/batch · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteConversationsBatch · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 413, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PATCH /api/conversations/{id}

PATCH /api/conversations/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgRenameConversation · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 413, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PATCH /api/conversations/{id}/profile

PATCH /api/conversations/{id}/profile · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgUpdateConversation · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 413, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/conversations/{id}

DELETE /api/conversations/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteConversation · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/conversations/{id}/messages

GET /api/conversations/{id}/messages · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgConversationMessages · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query before, limit, since · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · agent turn을 background context에서 실행할 수 있음; activity/stop/terminal event를 확인

POST /api/conversations/{id}/messages

POST /api/conversations/{id}/messages · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSendConversationMessage · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body JSON
status/error 직접 관찰 202, 400, 401, 404, 409, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · agent turn을 background context에서 실행할 수 있음; activity/stop/terminal event를 확인

POST /api/conversations/{id}/stop

POST /api/conversations/{id}/stop · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgStopConversation · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/conversations/{id}/messages/{seq}

GET /api/conversations/{id}/messages/{seq} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

  • 의존 / 실행 · /chat · 화면 component/hook에서 API wrapper 또는 EventSource 소비 · web-screen-chat
전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgConversationMsgDetail · server/conversations.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id, seq · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/agents

GET /api/agents · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 6개

전체 관계 8개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListAgents · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/agents

POST /api/agents · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgCreateAgent · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 409, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/agents/{key}

GET /api/agents/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgGetAgent · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

PATCH /api/agents/{key}

PATCH /api/agents/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgUpdateAgent · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/agents/{key}

DELETE /api/agents/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteAgent · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PUT /api/agents/{key}/config

PUT /api/agents/{key}/config · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveAgentConfig · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PUT /api/agents/{key}/prompt

PUT /api/agents/{key}/prompt · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSavePrompt · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/agents/{key}/prompt/reset

POST /api/agents/{key}/prompt/reset · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgResetPrompt · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PUT /api/agents/{key}/wrapup

PUT /api/agents/{key}/wrapup · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveWrapup · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/agents/{key}/wrapup/reset

POST /api/agents/{key}/wrapup/reset · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgResetWrapup · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PUT /api/agents/{key}/wrapup/task-timeout

PUT /api/agents/{key}/wrapup/task-timeout · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveTaskTimeoutWrapup · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/agents/{key}/wrapup/task-timeout/reset

POST /api/agents/{key}/wrapup/task-timeout/reset · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgResetTaskTimeoutWrapup · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/agents/{key}/triggers

GET /api/agents/{key}/triggers · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListTriggers · server/triggers.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/agents/{key}/triggers

POST /api/agents/{key}/triggers · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgCreateTrigger · server/triggers.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/agents/{key}/prompts

GET /api/agents/{key}/prompts · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListPromptVersions · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/agents/{key}/variables

GET /api/agents/{key}/variables · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgPromptVars · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/agents/{key}/prompt/preview

POST /api/agents/{key}/prompt/preview · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgPreviewPrompt · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/agents/{key}/visibility

GET /api/agents/{key}/visibility · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgGetAgentVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

PUT /api/agents/{key}/visibility

PUT /api/agents/{key}/visibility · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSetAgentVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/tools

GET /api/tools · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 5개

전체 관계 7개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListTools · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

PUT /api/tools/{key}

PUT /api/tools/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 3개

전체 관계 5개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgUpdateTool · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/tools/custom

POST /api/tools/custom · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgCreateCustomTool · server/customtool.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 409, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/tools/custom/test

POST /api/tools/custom/test · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgTestCustomTool · server/customtool.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

PUT /api/tools/custom/{key}

PUT /api/tools/custom/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgUpdateCustomTool · server/customtool.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/tools/custom/{key}

DELETE /api/tools/custom/{key} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteCustomTool · server/customtool.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/tools/{key}/reset

POST /api/tools/{key}/reset · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgResetTool · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path key · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/mcp

GET /api/mcp · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 5개

전체 관계 7개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListMCP · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/mcp

POST /api/mcp · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveMCP · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/mcp/{id}

DELETE /api/mcp/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteMCP · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/mcp/{id}/tools

GET /api/mcp/{id}/tools · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgMCPTools · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/mcp/{id}/refresh

POST /api/mcp/{id}/refresh · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgRefreshMCP · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500, 502, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · remote MCP discovery/refresh가 포함될 수 있으며 HTTP response가 해당 호출 완료 경계

GET /api/skills

GET /api/skills · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 4개

전체 관계 6개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsListSkills · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/skills

POST /api/skills · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsCreateSkill · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 201, 400, 401, 409, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/skills/upload

POST /api/skills/upload · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsUploadSkill · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query overwrite · body multipart/form-data
status/error 직접 관찰 201, 400, 401, 409, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/skills/{name}

DELETE /api/skills/{name} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsDeleteSkill · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/skills/missing

GET /api/skills/missing · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsMissingSkills · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query limit · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/skills/{name}/usage

GET /api/skills/{name}/usage · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsSkillUsage · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query limit · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

PUT /api/skills/{name}/meta

PUT /api/skills/{name}/meta · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsUpdateSkillMeta · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/skills/{name}/dirs

POST /api/skills/{name}/dirs · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsCreateDir · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query - · body JSON
status/error 직접 관찰 201, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/skills/{name}/files

GET /api/skills/{name}/files · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsListFiles · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

GET /api/skills/{name}/files/{file...}

GET /api/skills/{name}/files/{file...} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsReadFile · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name, file · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

PUT /api/skills/{name}/files/{file...}

PUT /api/skills/{name}/files/{file...} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsWriteFile · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name, file · query - · body JSON
status/error 직접 관찰 200, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/skills/{name}/files/{file...}

DELETE /api/skills/{name}/files/{file...} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler fsDeletePath · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name, file · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/visibility/{kind}/{id}

GET /api/visibility/{kind}/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgResourceVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path kind, id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/visibility/toggle

POST /api/visibility/toggle · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgToggleVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/visibility/skill/{name}

GET /api/visibility/skill/{name} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSkillVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path name · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/visibility/skill/toggle

POST /api/visibility/skill/toggle · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgToggleSkillVisibility · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/llm/profiles

GET /api/llm/profiles · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 6개

전체 관계 8개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListProfiles · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/llm/profiles

POST /api/llm/profiles · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveProfile · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

DELETE /api/llm/profiles/{id}

DELETE /api/llm/profiles/{id} · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgDeleteProfile · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 409, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/llm/profiles/active

POST /api/llm/profiles/active · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgActivateProfile · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/llm/retry-policy

GET /api/llm/retry-policy · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgGetLLMRetryPolicy · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/llm/retry-policy

POST /api/llm/retry-policy · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgSaveLLMRetryPolicy · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/llm/pool

GET /api/llm/pool · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgLLMPoolStatus · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장

POST /api/llm/pool/reset

POST /api/llm/pool/reset · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgLLMPoolReset · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

POST /api/llm/models

POST /api/llm/models · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 1개

전체 관계 3개 · 종류 선택·관계도
계약 확인 결과
등록·handler pgListModels · server/server_mgmt.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path - · query - · body JSON
status/error 직접 관찰 200, 400, 401 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P)

GET /api/conversations/{id}/side-questions

GET /api/conversations/{id}/side-questions · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler handleSideQuestions · server/side_questions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query before · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · history/current snapshot 조회가 응답 전에 끝남; before는 invalid/missing이면 0으로 처리

POST /api/conversations/{id}/side-questions

POST /api/conversations/{id}/side-questions · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler handleSideQuestions · server/side_questions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body JSON
status/error 직접 관찰 200, 202, 400, 401, 404, 409, 429, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 같은 client_request_id+question은 기존 request를 200으로 반환; 같은 ID의 다른 question은 409 · side-question session/request 시작; events/terminal request state가 완료 기준

DELETE /api/conversations/{id}/side-questions

DELETE /api/conversations/{id}/side-questions · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler handleSideQuestions · server/side_questions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path id · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 400, 401, 404, 500, 503 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음 · active run에 cancel을 요청하고 DB history clear 후 응답; run goroutine 종료까지 기다리지는 않음

GET /api/side-questions/{requestID}/events

GET /api/side-questions/{requestID}/events · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

이 대상을 사용하는 기능·모듈·계약 · 2개

전체 관계 4개 · 종류 선택·관계도
계약 확인 결과
등록·handler sideEvents · server/side_questions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path requestID · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation P: top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음
반복·완료 read/stream 요청; stream 재연결은 cursor 계약에 따름 · SSE 연결 수립; event lifecycle은 stream별 cursor/메모리 상태를 확인

POST /api/side-questions/{requestID}/cancel

POST /api/side-questions/{requestID}/cancel · 관계

이 대상이 사용하는 구현·계약·의존 · 2개

전체 관계 2개 · 종류 선택·관계도
계약 확인 결과
등록·handler cancelSideRequest · server/side_questions.go · handler 근거
인증 JWT 필요; extractToken이 Bearer→cookie→query token 순으로 선택
wire 입력 path requestID · query - · body 없음(직접 body decode 미발견)
status/error 직접 관찰 200, 401, 404, 500 · 일반 error body {error:string}; helper status는 schema에서 P/U
응답·validation C: 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P
반복·완료 Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P) · side-question session/request 시작; events/terminal request state가 완료 기준

이 페이지의 확인 한계

상위 영역: HTTP API와 Web UI 계약

전체로 돌아가기 · Markdown 원본

검색을 열면 색인을 읽습니다.

등록한 문서 본문에서 검색합니다.