Postman

제공 도구 14

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• postman__api_destructive파괴적승인 필요

  Postman 공식 API destructive 작업 실행 — operation·입력 스키마는 postman__operations 에서 조회한다. ⚠️ 데이터 삭제·리소스 교체·권한 변경은 되돌릴 수 없거나 별도 복구가 필요하다. 문서화된 path·query·headers·body 를 넣는다. 결과: ID · revision · 비동기 task · 페이지 정보와 데이터. 큰 응답은 절삭·비밀 값은 마스킹한다.

• postman__run_monitor파괴적승인 필요

  Postman 모니터를 지금 한 번 실행하고 끝날 때까지 기다린다. ⚠️ 컬렉션의 요청이 실제 외부 시스템으로 발송되고(쓰기 요청이면 그대로 반영된다) 실행은 되돌릴 수 없다. 최근 결과만 보려면 실행하지 말고 postman__get_monitor. 30초를 넘기면 시간 초과로 실패한다(서버 쪽 실행 여부는 알 수 없다). monitor_id 는 postman__list_monitors 결과의 id. 결과: ran · status · requests · assertions · failures(최대 5).

• postman__api_send발신승인 필요

  Postman 공식 API send 작업 실행 — operation·입력 스키마는 postman__operations 에서 조회한다. ⚠️ 게시·알림·외부 요청이 실행될 수 있고 전달된 요청은 회수할 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 문서화된 path·query·headers·body 를 넣는다. 결과: ID · revision · 비동기 task · 페이지 정보와 데이터. 큰 응답은 절삭·비밀 값은 마스킹한다.

• postman__api_write쓰기

  Postman 공식 API write 작업 실행 — operation·입력 스키마는 postman__operations 에서 조회한다. 문서화된 path·query·headers·body 를 넣는다. 결과: ID · revision · 비동기 task · 페이지 정보와 데이터. 큰 응답은 절삭·비밀 값은 마스킹한다.

• postman__api_read읽기

  Postman 공식 API read 작업 실행 — operation·입력 스키마는 postman__operations 에서 조회한다. 문서화된 path·query·headers·body 를 넣는다. 결과: ID · revision · 비동기 task · 페이지 정보와 데이터. 큰 응답은 절삭·비밀 값은 마스킹한다.

• postman__get_monitor읽기

  모니터 상세 — 스케줄(cron·시간대·다음 실행)과 마지막 실행 결과(상태·성공·실패 수). 「배포 후 통과했나」 에 답한다 — 실행하지 않는다. 결과: id · name · schedule · last_run(status · requests · assertions).

• postman__get_workspace읽기

  워크스페이스 상세 — 설명과 보유 자산(컬렉션·환경·모니터·mock·API) 개수 및 이름. "이 워크스페이스에 뭐가 있나" 에 한 번에 답한다

• postman__list_collections읽기

  컬렉션 목록 — postman__read_collection 에 쓸 uid 를 확보한다. workspace 를 생략하면 접근 가능한 전체

• postman__list_environments읽기

  환경 목록 — postman__read_environment 에 쓸 uid 를 확보한다. workspace 를 생략하면 접근 가능한 전체

• postman__list_monitors읽기

  모니터 목록 — 상세 조회·실행에 쓸 monitor id 를 얻는다. workspace 를 생략하면 접근 가능한 전체. 결과: 모니터마다 id · uid · name (최대 25건).

• postman__list_workspaces읽기

  워크스페이스 목록 — 다른 Postman 툴에 쓸 workspace id 를 여기서 확보한다

• postman__operations읽기

  Find Postman operations and their exact input schemas. Search by title or operation ID, then use the matching read/write/send/destructive tool. Schemas include path, query, headers and body. Administrative methods may require a paid plan or team role. Secret values are redacted.

• postman__read_collection읽기

  컬렉션 상세 — 폴더/요청 트리(메서드·이름·URL)와 필요한 변수 이름. ⚠️ 보안상 요청의 인증 설정·헤더·본문은 포함하지 않는다

• postman__read_environment읽기

  환경 변수 목록 — 어떤 키가 설정돼 있는지 확인한다. ⚠️ 비밀로 판정된 값(secret 타입 또는 token/password 류 키 이름)은 마스킹되어 나온다 — 값 자체는 조회할 수 없다

연동 준비

1. Settings → Account settings → API keys → Generate API Key 바로가기
2. 키는 PMAK- 로 시작합니다. 조회·모니터 실행 모두 같은 키 하나면 됩니다
3. ENDUE-1191: 확장 작업은 API 키 소유자의 워크스페이스·팀 역할과 제품 플랜이 필요합니다. 기존 키 권한은 자동으로 늘지 않습니다. 401/403이면 권한을 확인하고 허용된 키로 다시 연결하세요. OAuth·SCIM은 별도 자격증명으로 지원하지 않습니다. 글로벌/미국 API 호스트를 사용하며 EU 데이터 레지던시는 아직 지원하지 않습니다.