프로젝트 검색

MCP 도구

search_projectsSearch Projects

요청 제한

Tier 3

API 권한

projects:read

워크스페이스에서 접근 가능한 프로젝트를 검색합니다.

예시

curl -X QUERY 'https://api.youvico.com/api/projects' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "keyword": "launch" }'

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign",
      "description": "Social assets for Q4 launch",
      "accessRange": "ALLOW_WORKSPACE_MEMBER",
      "archivedAt": null,
      "updatedAt": "2026-04-10 08:20:00.318204"
    }
  ],
  "page": {
    "next": "WyIyMDI2LTA0LTEwIDA4OjIwOjAwLjMxODIwNCIsImJkYmZmNWRlLTk2ZDctNDY4Zi05ZGIwLTg1ZmUyOGJkNmI2MiJd",
    "prev": null
  }
}

요청

본문

keywordstringrequired

1-255 characters

검색어

Example: launch

nextstring

Maximum 2048 characters

page.next 커서

prevstring

Maximum 2048 characters

page.prev 커서

응답

200 OK를 반환합니다.

dataarray

검색된 프로젝트 목록

data[].idstring

프로젝트 ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

data[].namestring

프로젝트 이름

Example: Launch Campaign

data[].descriptionstring?

프로젝트 설명

Example: Social assets for Q4 launch

data[].accessRangestring

프로젝트 접근 범위

Possible values: ONLY_PROJECT_MEMBERALLOW_WORKSPACE_MEMBER

Example: ALLOW_WORKSPACE_MEMBER

data[].archivedAtstring?

보관 일시

Example: null

data[].updatedAtstring

프로젝트 마지막 수정 일시

Example: 2026-04-10 08:20:00.318204

pageobject

페이지네이션 커서

page.nextstring?

다음 페이지 커서

Example: WyIyMDI2LTA0LTEwIDA4OjIwOjAwLjMxODIwNCIsImJkYmZmNWRlLTk2ZDctNDY4Zi05ZGIwLTg1ZmUyOGJkNmI2MiJd

page.prevstring?

이전 페이지 커서

Example: null