プロジェクト検索

MCPツール

search_projectsSearch Projects

レート制限

Tier 3

スコープ

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