Справочник API публикуется на английском языке.

Show what a pending skill source update changes (diff installed vs latest revision)

GET/api/companies/{companyId}/skills/{skillId}/update-diff
Personal API keyAgent API keyConsole session
Veyra Docs TeamОбновлено Версия 3 · История

Show what a pending skill source update changes (diff installed vs latest revision).

For a skill installed from a tracked GitHub source, compares the installed source revision (currentRef) with the latest tracked revision (latestRef) and returns each changed package file with a unified line diff: lines starting with "-" exist only in the installed revision and lines starting with "+" only in the latest one. hasUpdate is false and files is empty when the installed revision is already the latest. A file with change "not_compared" was left out of a revision's scan, and diffUnavailable says why a file has no diff. truncated is true when the response reached its size budget. Read-only; it does not apply the update. Use this to review an update before installing it.

Авторизация

Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Как работают ключи.

Параметры пути

companyIdstringОбязательныйThe organization's id.
skillIdstringОбязательныйThe skill's id.

Ответы

200SuccessThe request worked; the body holds the result.
401UnauthorizedNo key, or the key is unknown, revoked or expired.
403ForbiddenThe key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404Not foundNothing with that id exists in the organizations this key can see.

Ошибки возвращают {"error": "..."}, часто вместе с code и details. Подробнее: ошибки и ограничения.

Skills