# 플러그 개발자 센터

## Docs

- [고객 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/client/create.md): 새 고객(`Client`)을 생성합니다. `status.id` 미지정 시 비즈니스의 기본 클라이언트 상태가 할당될 수 있으니, 원하는 상태가 있다면 명시적으로 전달하세요. 별도 알림 없음.
- [고객 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/client/delete.md): 고객을 삭제합니다. **Soft delete** (Client는 `SoftDeleteOrderedBaseModel`) — `is_deleted=True`로 마킹되며 목록 조회에서 제외됩니다.
- [고객 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/client/list.md): 비즈니스의 고객 목록을 최신순(`created` DESC)으로 조회합니다.
- [고객 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/client/patch.md): 고객 정보를 부분 수정합니다. `status.id` 변경 시 별도 상태 이력은 기록되지 않습니다 (의뢰와 달리).
- [고객 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/client/retrieve.md): 단일 고객의 상세 정보를 조회합니다. 회사 정보, 담당자, 연락처, 상태(`status`)가 nested로 포함됩니다.
- [고객 상태 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/client/status/list.md): 비즈니스의 고객 상태(`ClientStatus`) 카탈로그를 조회합니다.
- [계약 카테고리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/category/list.md): 비즈니스의 계약 카테고리(ContractCategory) 카탈로그를 `order` 내림차순으로 조회합니다.
- [계약 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/create.md): 새 계약을 생성합니다.
- [계약 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/delete.md): 계약을 삭제합니다. **Soft delete** (Contract는 `SoftDeleteOrderedBaseModel`) — `is_deleted=True`로 마킹되며 목록 조회에서 제외됩니다. 연결된 의뢰의 `contract` 참조는 자동 해제되지 않으니 필요 시 의뢰 수정 API로 별도 처리.
- [계약 히스토리 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/history/create.md): 계약에 새 텍스트 히스토리를 추가합니다. `member` 미지정 시 작성 멤버는 null로 기록됩니다 (외부 API 호출 컨텍스트). 별도 알림은 발송되지 않습니다.
- [계약 히스토리 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/history/delete.md): 텍스트 히스토리를 삭제합니다. **Hard delete** (`ContractTextHistory`는 `BaseModel`) — DB에서 영구 제거됩니다.
- [계약 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/history/list.md): 특정 계약의 텍스트 히스토리(`ContractTextHistory`) 목록을 조회합니다. 각 항목은 content, 작성 멤버(`member`), 생성 시간(`created`)을 포함합니다.
- [계약 히스토리 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/history/patch.md): 텍스트 히스토리의 `content` 필드를 수정합니다. 별도 알림 없음.
- [계약 히스토리 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/history/retrieve.md): 단일 텍스트 히스토리의 상세를 조회합니다. content, 작성 멤버, 생성 시간을 포함합니다.
- [계약 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/list.md): 비즈니스의 계약 목록을 최신순(`created` DESC)으로 조회합니다.
- [계약 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/patch.md): 계약 정보를 부분 수정합니다. `inquiry` 변경 시 의뢰 ↔ 계약 1:1 관계가 재설정되며, 기존 연결된 의뢰는 자동으로 해제됩니다. `category_set`은 전체 재설정 방식.
- [계약 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/contract/retrieve.md): 단일 계약의 상세 정보를 조회합니다. 연결된 의뢰, 고객, 카테고리, 정산 관련 필드를 모두 포함합니다.
- [견적서 항목 템플릿 분류 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/classification/list.md): 비즈니스의 견적서 항목 분류(`BusinessEstimateItemClassification`) 카탈로그를 조회합니다.
- [견적서 항목 템플릿 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/create.md): 새 견적서 항목을 생성합니다. `classification.id`로 분류를 지정합니다(별도 분류 목록 API 참조). 단가(`unit_cost`), 단위(`unit`), 설명 등 필드는 스키마의 help_text 참조.
- [견적서 항목 템플릿 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/delete.md): 견적서 항목을 삭제합니다. **Hard delete** (`BusinessEstimateItem`은 `BaseModel`) — DB에서 영구 제거됩니다.
- [견적서 항목 템플릿 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/list.md): 비즈니스의 견적서 항목(`BusinessEstimateItem`) 목록을 조회합니다. 각 항목은 분류(`classification`)로 그룹화됩니다.
- [견적서 항목 템플릿 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/patch.md): 견적서 항목의 단가(`unit_cost`), 단위(`unit`), 분류(`classification`) 등을 수정합니다. 별도 알림 없음.
- [견적서 항목 템플릿 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/estimate/item/retrieve.md): 단일 견적서 항목의 상세 정보를 조회합니다. 분류, 단가, 단위, 설명 등을 포함합니다.
- [필드 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/field/list.md): 비즈니스의 커스텀 필드(`Field`) 목록을 조회합니다. 각 필드는 옵션(`option_set`)을 nested로 포함합니다.
- [폴더 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/folder/list.md): 비즈니스의 폴더(`Folder`) 목록을 조회합니다. **정렬:** `is_default=True`인 기본 폴더가 먼저, 그 다음 생성순 역순(`-created`).
- [의뢰 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/create.md): 새 의뢰를 생성합니다.
- [의뢰 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/delete.md): 의뢰를 삭제합니다. **Soft delete** (Inquiry는 `SoftDeleteOrderedBaseModel`) — DB에서는 `is_deleted=True`로 마킹되며 목록 조회에서 자동 제외됩니다.
- [의뢰 이메일 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/email-history/list.md): 의뢰에서 발송한 이메일 이력을 조회합니다. 수신자(to), 참조(cc), 발송 상태(S:발송, D:임시저장, C:발송예약, F:실패) 정보를 포함합니다.
- [의뢰 이메일 회신 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/email-reply-history/list.md): 의뢰에 대해 수신된 답장 이메일 이력을 조회합니다. 발신자(from), 수신자(to), 참조(cc), 읽지 않음 여부(is_unread) 정보를 포함합니다.
- [의뢰 파일 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/file/delete.md): 의뢰에 첨부된 특정 파일을 삭제합니다. 삭제할 파일의 ID는 의뢰 상세 조회 API의 `file_set[].id`에서 확인할 수 있습니다.
- [의뢰 폴더 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/folder-history/list.md): 의뢰의 폴더 이동 이력을 조회합니다. 이전 폴더명, 현재 폴더명, 변경한 멤버 정보를 포함합니다.
- [의뢰 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/list.md): 비즈니스의 의뢰 목록을 최신순(`created` DESC)으로 조회합니다.
- [의뢰 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/patch.md): 의뢰 정보를 부분 수정합니다.
- [의뢰 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/retrieve.md): 의뢰 상세 정보를 조회합니다. `file_set`에 첨부 파일 목록이 presigned 다운로드 URL과 함께 포함됩니다.
- [의뢰 단계 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/status-history/list.md): 의뢰의 상태 변경 이력을 조회합니다. 변경된 상태명, 상징 색, 변경한 멤버 정보를 포함합니다.
- [의뢰 단계 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/status/list.md): 비즈니스의 의뢰 상태(InquiryStatus) 카탈로그를 조회합니다.
- [의뢰 웹폼 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/submit-history/list.md): 의뢰에 연결된 웹 폼 제출 이력을 조회합니다. 제출된 폼의 ID와 제목 정보를 포함합니다.
- [의뢰 텍스트 히스토리 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/text-history/create.md): 의뢰에 새로운 텍스트 히스토리를 추가합니다. 담당자에게 알림이 발송됩니다.
- [의뢰 텍스트 히스토리 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/text-history/delete.md): 텍스트 히스토리를 삭제합니다. **Hard delete** (`InquiryTextHistory`는 `BaseModel`) — DB에서 영구 제거됩니다. 별도 알림 없음.
- [의뢰 텍스트 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/text-history/list.md): 의뢰의 텍스트 히스토리를 조회합니다. 내용, 작성 멤버, 생성 시간 정보를 포함합니다.
- [의뢰 텍스트 히스토리 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/text-history/patch.md): 텍스트 히스토리의 `content` 필드를 수정합니다. **알림은 발송되지 않습니다** (생성 시에만 발송).
- [의뢰 텍스트 히스토리 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/text-history/retrieve.md): 특정 텍스트 히스토리의 상세 정보를 조회합니다. content, 작성 멤버(`member`), 생성 시간(`created`)을 포함합니다.
- [의뢰 작업 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/inquiry/work/list.md): 비즈니스에 등록된 업무(Work) 카탈로그를 조회합니다.
- [로그 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/log/list.md): 현 비즈니스의 openapi 호출 로그를 조회합니다.
- [멤버 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/member/list.md): 비즈니스의 멤버(`Member`) 목록을 최신순(`created` DESC)으로 조회합니다. 각 멤버는 사용자 정보(`user`)와 등급(`grade`)을 nested로 포함합니다.
- [Presigned URL 발급](https://docs.openapi.pluuug.com/api-reference/endpoints/presigned/create.md): S3 업로드용 presigned PUT URL을 발급합니다.
- [프로젝트 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/project/create.md): 새 프로젝트를 생성합니다. `contract.id`로 계약 연결 가능 (선택).
- [프로젝트 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/project/delete.md): 프로젝트를 삭제합니다. **Soft delete** (Project는 `SoftDeleteBaseModel`) — `is_deleted=True`로 마킹.
- [프로젝트 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/project/list.md): 비즈니스의 프로젝트 목록을 조회합니다. 연결된 계약(`contract`)이 nested로 포함됩니다.
- [프로젝트 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/project/patch.md): 프로젝트 정보를 부분 수정합니다. 상태(`status`) 의미는 필드 help_text 참조 (예정/진행 중/추가 기간/종료됨). **플랜 제약:** FREE/AGENCY 전용.
- [프로젝트 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/project/retrieve.md): 단일 프로젝트의 상세 정보를 조회합니다. **플랜 제약:** FREE/AGENCY 전용.
- [정산 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/create.md): 새 정산을 생성합니다.
- [정산 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/delete.md): 정산을 삭제합니다. **Soft delete** (Settlement는 `SoftDeleteOrderedBaseModel`) — `is_deleted=True`로 마킹되며 목록에서 제외됩니다.
- [정산 히스토리 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/history/create.md): 정산에 새 텍스트 히스토리를 추가합니다. `member` 미지정 시 작성 멤버는 null (외부 API 호출 컨텍스트). 별도 알림 없음.
- [정산 히스토리 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/history/delete.md): 텍스트 히스토리를 삭제합니다. **Hard delete** (`SettlementTextHistory`는 `BaseModel`) — DB에서 영구 제거됩니다.
- [정산 히스토리 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/history/list.md): 특정 정산의 텍스트 히스토리(`SettlementTextHistory`) 목록을 조회합니다. 각 항목은 content, 작성 멤버(`member`), 생성 시간을 포함합니다.
- [정산 히스토리 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/history/patch.md): 텍스트 히스토리의 `content` 필드를 수정합니다. 별도 알림 없음.
- [정산 히스토리 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/history/retrieve.md): 단일 텍스트 히스토리의 상세를 조회합니다. content, 작성 멤버, 생성 시간을 포함합니다.
- [정산 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/list.md): 비즈니스의 정산 목록을 최신순(`created` DESC)으로 조회합니다. 연결된 계약(`contract`)과 정산 형태(`type`)가 nested로 포함됩니다.
- [정산 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/patch.md): 정산 정보를 부분 수정합니다.
- [정산 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/retrieve.md): 단일 정산의 상세 정보를 조회합니다. 계약/정산 형태/날짜 필드 일체를 포함합니다.
- [정산 형태 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/settlement/type/list.md): 비즈니스의 정산 형태(`SettlementType`) 카탈로그를 생성순(`created`)으로 조회합니다.
- [Todo 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/todo/create.md): 새 Todo를 생성합니다. `inquiry.id`(필수)로 의뢰 연결, `in_charge.id`로 담당자 지정.
- [Todo 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/todo/delete.md): Todo를 삭제합니다. **Hard delete** (`InquiryTodo`는 `BaseModel`) — DB에서 영구 제거됩니다.
- [Todo 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/todo/list.md): 비즈니스의 Todo 목록(`InquiryTodo`)을 조회합니다. Todo는 의뢰(`Inquiry`)에 종속되며 담당자(`in_charge`)가 지정됩니다.
- [Todo 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/todo/patch.md): Todo 정보를 부분 수정합니다. **완료 처리** (`is_completed=true`)할 때 `completed_in_charge`가 자동 설정됩니다. 별도 알림은 발송되지 않습니다.
- [Todo 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/todo/retrieve.md): 단일 Todo의 상세 정보를 조회합니다. 의뢰, 담당자, 완료 담당자(`completed_in_charge`) 정보를 포함합니다.
- [실무자 생성](https://docs.openapi.pluuug.com/api-reference/endpoints/worker/create.md): 새 실무자를 생성합니다. `position.id`로 직급 연결(선택).
- [실무자 삭제](https://docs.openapi.pluuug.com/api-reference/endpoints/worker/delete.md): 실무자를 삭제합니다. **Soft delete** (Worker는 `SoftDeleteBaseModel`, `perform_destroy`에서 `instance.delete()` 호출 시 `is_deleted=True`로 마킹). 삭제된 실무자는 목록 조회에서 제외됩니다.
- [실무자 목록 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/worker/list.md): 비즈니스의 실무자(`Worker`) 목록을 조회합니다. 삭제된 실무자(`is_deleted=True`)는 제외됩니다.
- [실무자 부분 수정](https://docs.openapi.pluuug.com/api-reference/endpoints/worker/patch.md): 실무자 정보를 부분 수정합니다. `position.id` 변경 시 직급이 재할당됩니다. **플랜 제약:** FREE/AGENCY 전용.
- [실무자 단일 조회](https://docs.openapi.pluuug.com/api-reference/endpoints/worker/retrieve.md): 단일 실무자의 상세 정보를 조회합니다. 직급(`position`) 정보를 포함합니다. **플랜 제약:** FREE/AGENCY 전용.
- [🔐 인증 방식](https://docs.openapi.pluuug.com/authentication.md): 플러그 오픈 API는 API Key와 Signature 기반의 인증 방식을 사용합니다.
- [📋 변경 기록](https://docs.openapi.pluuug.com/changelog.md): 플러그 오픈 API의 버전별 변경 사항을 안내합니다.
- [🤖 MCP 통합](https://docs.openapi.pluuug.com/integrations/mcp.md): Claude Desktop, Cursor 등에서 플러그 API를 자동 호출하도록 MCP(Model Context Protocol) 서버를 설치합니다.
- [플러그 개발자센터](https://docs.openapi.pluuug.com/introduction.md): 플러그 개발자 문서에 오신 것을 환영합니다.
- [🔄 웹훅](https://docs.openapi.pluuug.com/webhook.md): 플러그 API는 특정 이벤트가 발생할 때 자동으로 HTTP POST 요청을 보내는 웹훅을 지원합니다.

## OpenAPI Specs

- [openapi](https://docs.openapi.pluuug.com/api-reference/openapi.json)