Ping

MCPツール

whoamiWho Am I

レート制限

Default

APIキーまたはOAuthアクセストークンを確認し、紐づくワークスペースとスコープを返します。

例

curl 'https://api.youvico.com/api/ping' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": {
    "pong": true,
    "workspace": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Acme Inc.",
      "avatarUrl": "https://files.youvico.com/workspaces/a1b2c3d4-e5f6-7890-abcd-ef1234567890/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
    },
    "scopes": ["projects:read", "files:read"]
  }
}

リクエスト

パラメータはありません。

レスポンス

200 OK を返します。

dataobject

Ping結果

data.pongboolean

常に true

Example: true

data.workspaceobject

APIキーまたはOAuth連携に紐づくワークスペース

data.workspace.idstring

ワークスペースID

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

data.workspace.namestring

ワークスペース名

Example: Acme Inc.

data.workspace.avatarUrlstring?

ワークスペースアバターURL

Example: https://files.youvico.com/workspaces/a1b2c3d4-e5f6-7890-abcd-ef1234567890/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif

data.scopesstring[]

APIキーまたはOAuth連携のスコープ

Possible values: projects:readprojects:writefolders:readfolders:writefiles:readfiles:writefiles:downloadai:generatecomments:readcomments:writecomments:downloadworkspace-members:readproject-members:readproject-members:writeaccess-links:readaccess-links:writeaccess-links:read.keyskills:readskills:write