GET/groups/{groupId}/note/posts/search

권한이 있는 조직/그룹 노트의 게시글을 검색한다.
검색어(query)는 필수이다.

  • 기본 검색 대상: 제목, 본문, 댓글, 첨부 파일명, 작성자명
  • 검색어는 대소문자를 구분하지 않으며, URL 인코딩을 적용해야 한다.
  • 검색 결과는 관련도(relevance) 내림차순으로 정렬된다.
  • 기간/작성자/첨부 필터는 지원하지 않으며 항상 전체 기간을 검색한다.
  • 응답은 노트 게시글 목록 조회와 동일한 모델을 사용하며, 검색 응답에서만 snippet이 추가로 제공된다.
  • readCount/likeCount는 검색 인덱스에 동기화되지 않아 항상 0이며, enableCollaboration은 항상 true이다.
  • 게시글 등록/수정 후 검색 인덱스 반영까지 수 초간 지연될 수 있다.
  • rate limit은 Open API 공통 rate limit 정책을 따른다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증를 참고한다.

Scope

group.note
group.note.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/groups/{groupId}/note/posts/search

Path Parameters

ParameterTypeDescription
groupId string 

조직/그룹 ID


required
example : group127-8545-4463-603b-04d550d23bf 

Query Parameters

ParameterTypeDescription
query string 

검색어


required
minLength : 1
maxLength : 100
example : 회의록 
count integer 

목록 조회 개수


default : 20
minimum : 1
maximum : 40 
cursor string 

다음 목록 조회 시 사용하는 값


example : sfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
posts array (undefined) 

게시글 검색 결과 목록

 
responseMetaData object (responseMetaData) 

페이지 매김 처리를 위한 메타데이터

 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 페이지 조회를 위한 커서

 

Response Example

example

1{2  "posts": [3    {4      "postId": 1,5      "title": "주간 회의록",6      "enableCollaboration": true,7      "readCount": 0,8      "commentCount": 2,9      "fileCount": 1,10      "likeCount": 0,11      "createdTime": "2026-04-20T10:30:00+09:00",12      "modifiedTime": "2026-04-21T14:15:00+09:00",13      "userId": "user7149-0ccd-433d-1eba-04f6901660dc",14      "userName": "Susan Nielsen",15      "isNotice": false,16      "snippet": "이번 주 <mark>회의록</mark>을 공유합니다."17    }18  ],19  "responseMetaData": {20    "nextCursor": "sfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="21  }22}