Origin API

Origin — платформа Cursor для разработки кода. Её публичный REST API позволяет приложениям и инструментам работать с репозиториями Origin, коммитами, проверками, pull request и установками приложений.

• Origin Apps проходят аутентификацию с помощью JWT приложений и токенов доступа установки. См. раздел Аутентификация.
• Полную спецификацию OpenAPI с подробными схемами и примерами можно посмотреть здесь.
• Агенты могут загрузить индекс llms.txt или полную справочную документацию в формате Markdown по адресу llms-full.txt.

Обзор

Приложения Origin используют модель согласия на установку в стиле OAuth и модель аутентификации в стиле GitHub App:

1. Приложение подписывает краткосрочный EdDSA JWT своим приватным ключом Ed25519.
2. Приложение обменивает этот JWT и идентификатор установки на краткосрочный токен доступа установки (oit_…).
3. Токен установки обращается к API репозиториев и аутентифицирует Git по HTTPS в пределах одобренных для установки репозиториев и областей доступа.
4. Origin отправляет подписанные доставки вебхука на зарегистрированный URL вебхука приложения.

Базовый URL

https://api.cursor.com/v1/origin

Пути к конечной точке в справочнике включают полный префикс /v1/origin.

Соглашения протокола

Для запросов и ответов используется application/json. В именах полей JSON используется camelCase. Метки времени указываются в виде строк RFC 3339. 64-битные целые числа Protobuf, включая номера pull request и номера версий, кодируются как строки JSON.

Ответы содержат поля со значениями по умолчанию, а не опускают их, поэтому логическое значение false, число 0, пустая строка и пустой массив присутствуют в теле. Считывайте само значение, а не трактуйте отсутствующий ключ как значение по умолчанию. Поля, описанные в документации как отсутствующие или опускаемые, являются необязательными в контракте и не включаются в тело, если не заданы.

Предварительная версия

Часть API публикуется в предварительной версии. Она описана в этом справочнике и в спецификации, но её структура может измениться до общего релиза. В спецификации OpenAPI такие элементы помечены как x-cursor-visibility: PREVIEW. Эта пометка может стоять на операции, параметре, схеме или отдельном поле, поэтому даже стабильная операция может возвращать поле из предварительной версии. Конечные точки в предварительной версии отмечены в этом справочнике значком Preview. Считайте такие поля необязательными и не закладывайте жёсткую зависимость от их структуры.

Начало работы

Доступ к Origin

• Откройте Origin на cursor.com/codebase.
• Управляйте настройками приложений на cursor.com/codebase/settings/apps.
• Создайте ключ подписи приложения и зарегистрируйте только открытый ключ.

Origin CLI

Установите Origin CLI и войдите в систему:

curl -fsSL https://downloads.cursor.com/origin/install.sh | shorigin auth login

Клонируйте существующий репозиторий:

origin repo clone '{ownerSlug}/{repoName}'# или напрямую через gitgit clone 'https://origin.cursor.com/{ownerSlug}/{repoName}.git'

Apps клонируют через аутентификацию Git по HTTPS с токеном доступа установки, а не с учётными данными пользователя.

Установка

Попросите администратора рабочей области клиента перейти по ссылке:

https://cursor.com/codebase/apps/install  ?client_id=APP_ID  &scope=SPACE_SEPARATED_SCOPES  &redirect_uri=REGISTERED_CALLBACK  &state=RANDOM_ANTI_FORGERY_VALUE  &summary=SHORT_REASON_FOR_ACCESS  &include_granted_scopes=true

Администратор рабочей области выбирает целевого владельца, одобренные области доступа, а также все репозитории или выбранные репозитории. Доступ к репозиториям контролирует клиент, а не приложение.

После одобрения Origin перенаправляет на зарегистрированный обратный вызов:

https://ci.example.com/origin/callback?installation_receipt=RECEIPT_JWT

Проверьте квитанцию об установке, затем сохраните идентификатор установки из утверждения sub. Он понадобится при выпуске токена доступа установки.

Установки используют один из двух режимов выбора репозиториев:

• all: установка может получать доступ ко всем репозиториям, принадлежащим выбранной цели.
• selected: установка может получать доступ только к репозиториям, выбранным администратором рабочей области.

Оба режима распространяются на зеркальные репозитории и нативные репозитории Origin, поэтому зеркало появляется в GET /installation/repos и его можно выбрать. Для установки зеркало доступно только для чтения: см. Зеркальные репозитории.

Используйте GET /installation/repos с токеном установки, чтобы узнать, какие репозитории доступны для этой установки. Конечные точки JWT приложения позволяют выводить список установок приложения, просматривать их и удалять. Удаление установки предотвращает выпуск новых токенов.

Квитанция об установке

installation_receipt — это краткосрочный компактный JWT, подписанный Origin. Он подтверждает, что одобрение установки поступило от Origin, а не было подделано при перенаправлении, и содержит всё необходимое для обратного вызова. Cursor не выполняет перенаправление без него, поэтому он всегда включается во внешние обратные вызовы.

Заголовок JOSE:

{  "alg": "EdDSA",  "kid": "origin-key-id",  "typ": "origin-installation-receipt+jwt"}

Утверждения:

{  "iss": "https://api.cursor.com/v1/origin",  "aud": "app_01...",  "sub": "i_01...",  "namespace_id": "ns_01...",  "iat": 1786465200,  "exp": 1786465500,  "jti": "RECEIPT_UUID",  "installedBy": {    "id": "user_01...",    "email": "installer@example.com",    "displayName": "Jane Doe"  },  "state": "ORIGINAL_VALUE"}

• aud — идентификатор вашего приложения, а sub — идентификатор установки, который следует использовать при выпуске токенов доступа установки.
• namespace_id — стабильный идентификатор пространства имён, в котором установлено приложение.
• installedBy определяет пользователя, выполнившего эту установку или повторное согласие. Он описывает текущее действие, поэтому при повторном согласии может отличаться от устойчивого installedBy в Получить установку приложения. Он содержит displayName, если у аккаунта есть имя, и никогда не содержит handle; вместо этого считывайте handle из ответа REST или payload вебхука.
• Срок действия квитанции об установке истекает через пять минут после выпуска. jti уникален для каждой квитанции об установке.
• state присутствует, только если URL установки содержал непустой state, и повторяет его значение. Сопоставьте его со значением защиты от подделки, которое вы создали до перенаправления.

Проверяйте квитанцию об установке, прежде чем доверять обратному вызову: определите ключ подписи из JWKS по заголовку kid, требуйте alg EdDSA и typ origin-installation-receipt+jwt, а также проверяйте подпись, iss, aud и exp. Отклоняйте обратный вызов, если проверка не пройдена.

Квитанция об установке не является токеном доступа установки. Никогда не отправляйте её как учётные данные Bearer; вместо этого выпускайте токены установки через Создать токен доступа установки.

Аутентификация

Передавайте учетные данные REST по схеме Bearer. Значки Auth у каждой конечной точки показывают, какие типы учетных данных он принимает:

curl --request GET \  --url https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME \  --header "Authorization: Bearer $ORIGIN_BEARER_TOKEN"

Создание ключа подписи приложения

Origin Apps используют для аутентификации пару ключей Ed25519. Создайте пару локально, затем зарегистрируйте только открытый ключ на cursor.com/codebase/settings/apps. Приложение может иметь до 10 активных ключей подписи.

Создайте приватный ключ PKCS#8 и открытый ключ PEM SPKI с помощью OpenSSL:

openssl genpkey -algorithm ED25519 -out origin-app-private.pemopenssl pkey -in origin-app-private.pem -pubout -out origin-app-public.pem

Файл открытого ключа начинается с -----BEGIN PUBLIC KEY-----. Вставьте этот PEM при добавлении ключа подписи. Используйте соответствующий приватный ключ только для подписи app JWT.

App JWT

Подпишите краткосрочный JWT приватным ключом Ed25519, соответствующим одному из активных ключей подписи приложения. Создайте эту пару, как описано в разделе Создание ключа подписи приложения.

Заголовок JOSE:

{  "alg": "EdDSA",  "kid": "app_01...",  "typ": "JWT"}

Утверждения:

{  "iss": "app_01...",  "aud": "origin-apps",  "iat": 1782928800,  "exp": 1782929100}

Задайте для iss и kid идентификатор приложения. Установите срок действия около пяти минут.

Authorization: Bearer APP_JWT

Используйте App JWT для операций на уровне приложения: чтения его метаданных, управления установками, выпуска токенов установки и повторной доставки вебхука.

Токен доступа установки

Выполните запрос POST /app/installations/{installationId}/access_tokens с JWT приложения. Токены установки начинаются с oit_.

Authorization: Bearer oit_...

Ответ содержит expiresAt. Выпускайте токены непосредственно перед использованием, обновляйте их до истечения срока действия, обращайтесь с ними как с паролями и никогда не записывайте в логи.

Срок действия токена истекает не позже чем через 15 минут после создания и никогда не позже, чем у JWT приложения, по которому он был запрошен, поэтому рекомендованный выше пятиминутный JWT даёт токен не более чем на пять минут. Считывайте expiresAt и выпускайте новый токен по его истечении, а не полагайтесь на фиксированную длительность: токены Origin живут меньше, чем токены установки GitHub App, и интеграция, повторно использующая токен по расписанию GitHub, перестанет работать после истечения срока действия токена. Подписывайте JWT с более поздним exp, если задаче нужны все 15 минут, — как это сделано в рецепте CloneKit для CI.

Удаление установки или приложения делает токены установки недействительными до expiresAt. После этого REST API и Git по HTTPS отклоняют токен с кодом 401. Не повторяйте попытку с тем же токеном; приложение необходимо переустановить, прежде чем оно сможет выпустить рабочий токен.

Токен установки не может предоставлять больше прав, чем одобренные для установки область доступа или доступ к репозиториям. Токен можно ограничить меньшим набором scopes или repositoryIds. Пустые или пропущенные массивы наследуют полный набор разрешений установки.

Используйте токены установки для операций, ограниченных репозиторием, включая pull requests, запись результатов проверок и Git по HTTPS.

Чтобы действовать от имени участника пространства имён установки, а не от имени приложения, выпустите пользовательский токен установки. См. Действия от имени пользователей.

Аутентификация Git по HTTPS

Токены доступа установки используются для аутентификации Git по HTTPS. Конечная точка Git использует базовую аутентификацию HTTP: пароль — токен установки, имя пользователя — x-access-token. Учетные данные Bearer предназначены для REST API; Git по HTTPS их не принимает.

Выпускайте токен с помощью Создать токен доступа установки непосредственно перед операцией Git. Срок действия токена — не более 15 минут.

Для клонирования, fetch и pull требуется repository:contents:read. Для push требуется repository:contents:write. Токен должен включать целевой репозиторий в предоставленных разрешениях.

Для push также требуется, чтобы владелец репозитория имел право записи в Origin — такое же требование действует для Создать репозиторий. Владелец-пользователь должен использовать тариф Pro, Pro Student, Pro+, Ultra или Start. Владелец-команда должна иметь активный платный тариф команды, не использовать режим конфиденциальности (устаревшая версия), а Origin не должен быть отключён администратором команды. Push в репозиторий, владелец которого не соответствует этим требованиям, возвращает 403. Для клонирования, fetch и pull это требование не действует.

Получите cloneUrl из Получить репозиторий или Список репозиториев установки приложения. Клонирование поддерживается как по пути в формате GitHub (https://origin.cursor.com/OWNER_SLUG/REPO_NAME.git), так и по устаревшему пути /git/.

git clone "https://x-access-token:${INSTALLATION_TOKEN}@origin.cursor.com/OWNER_SLUG/REPO_NAME.git"

Токен, встроенный в URL, сохраняется в .git/config. После успешного клонирования измените URL удалённого репозитория, чтобы последующие команды не использовали истёкший секрет:

git remote set-url origin "https://origin.cursor.com/OWNER_SLUG/REPO_NAME.git"

Чтобы не указывать токен в URL удалённого репозитория, передайте его через помощник Git для учётных данных:

git -c credential.helper="!f() { echo username=x-access-token; echo password=${INSTALLATION_TOKEN}; }; f" \  clone "https://origin.cursor.com/OWNER_SLUG/REPO_NAME.git"

Помощник учётных данных Origin CLI предназначен для входа пользователей. Интеграции приложений передают токен установки, как показано здесь. Обращайтесь с токеном как с паролем: никогда не записывайте его в логи и выпускайте новый до expiresAt, если задаче по-прежнему нужен доступ к Git.

Для Git по HTTPS действует собственный лимит, отдельный от лимита REST, описанного в разделе Ограничения частоты запросов. Учитываемый ответ Git содержит те же заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Used, но в X-RateLimit-Resource указано git, а не core. Запросы Git сверх лимита возвращают 429 с Retry-After и X-RateLimit-Reset. Регулируйте темп задачи по заголовкам, а не по предполагаемому числу; неучитываемые запросы заголовков ограничения частоты запросов не содержат.

В зеркальном репозитории токен установки позволяет клонировать, выполнять fetch и pull, а Origin отклоняет git push с кодом 403. См. Зеркальные репозитории.

Запросы CLI с аутентификацией пользователя

Используйте origin api для запросов с аутентификацией пользователя. Для интерактивной сессии войдите в систему через браузер:

origin auth loginorigin api /repos/OWNER_SLUG/REPO_NAME/pulls

Для неинтерактивной сессии укажите личный пользовательский API-ключ из Cursor Dashboard → API Keys:

export CURSOR_API_KEY="YOUR_PERSONAL_USER_API_KEY"origin api /repos/OWNER_SLUG/REPO_NAME/pulls

CLI обменивает личный пользовательский API-ключ на краткосрочный пользовательский токен доступа и передаёт этот токен в заголовке Authorization. Не отправляйте сам API-ключ на конечную точку Origin. Интеграциям приложений следует вместо этого использовать app JWT и токены доступа установки.

Discovery и ключи подписи

Origin публикует общедоступные метаданные Discovery и свои активные ключи подписи. Эти же ключи подписывают доставки вебхуков и квитанции об установке.

Метаданные Discovery содержат issuer и jwks_uri:

curl https://api.cursor.com/v1/origin/.well-known/openid-configuration

{  "issuer": "https://api.cursor.com/v1/origin",  "jwks_uri": "https://api.cursor.com/v1/origin/keys",  "response_types_supported": ["id_token"],  "subject_types_supported": ["public"],  "id_token_signing_alg_values_supported": ["EdDSA"]}

/keys возвращает активные JWK Ed25519:

curl https://api.cursor.com/v1/origin/keys

{  "keys": [    {      "kty": "OKP",      "crv": "Ed25519",      "use": "sig",      "alg": "EdDSA",      "kid": "origin-key-id",      "x": "PUBLIC_KEY_MATERIAL"    }  ]}

Кэшируйте JWKS. /keys отправляет Cache-Control: public, max-age=600, stale-if-error=600, поэтому используйте кэшированный ответ в течение 10 минут, затем обновляйте его; если обновление не удалось, используйте последние корректные ключи не более ещё 10 минут, прежде чем проверка завершится ошибкой. Также обновляйте при подписи, которую не удаётся проверить ни одним ключом, — это исключит идентификатор выведенного из обращения ключа. Ключи меняются еженедельно.

Подписи вебхуков не содержат идентификатор ключа, поэтому при проверке следует попробовать все активные ключи Ed25519. Квитанции об установке содержат kid ключа подписи в заголовке JOSE, поэтому ключ для проверки квитанции можно определить напрямую.

Области доступа

Запрашивайте только те области доступа, которые действительно нужны вашему приложению. repository:metadata:read, а также доступ к метаданным приложения или установки предоставляются автоматически и не должны отдельно добавляться в URL установки.

Запрос области доступа :write также предоставляет соответствующую область доступа :read, поэтому repository:labels:write включает repository:labels:read, и вам не нужно указывать обе. Обратное неверно: область доступа для чтения никогда не предоставляет права на запись.

Токен установки может только сужать эти разрешения. Он не может добавить область доступа или репозиторий, не одобренные администратором рабочей области.

Изменения состояния зеркала не входят в эту таблицу. Transition Repo Mirror и Detach Repo Mirror используют repository:mirror:write или repository:mirror:delete, которые приложение не может запросить при установке: они входят в учётные данные пользователя Cursor, а вызывающая сторона также должна администрировать репозиторий в вышестоящем источнике зеркала.

Управление установками тоже не входит в неё. Добавить репозитории установки приложения использует namespace:installations:write, которую приложение не может запросить при установке: ею обладает администратор пространства имён в учётных данных пользователя Cursor, и расширить установку могут учётные данные того же типа, что дали согласие на установку.

Управление приложениями не входит в неё по той же причине. создать приложение использует namespace:apps:create, List Namespace Apps и Get App — namespace:apps:read, а Update App, Add ключ подписи приложения и Revoke ключ подписи приложения — app:settings:write. Издатель имеет их в учётных данных пользователя Cursor; приложение не может запросить их для себя.

В таблице перечислены области доступа, которые приложение запрашивает при установке. Чтобы узнать, какая область доступа требуется для отдельной операции, прочитайте её расширение x-origin-scopes в спецификации OpenAPI. Это расширение охватывает все операции, включая области доступа app, installation и namespace, которые входят в состав самих учётных данных, а не предоставляются разрешением при установке. Операция, все области доступа которой входят в состав учётных данных, помечается в расширении как ambient: true: запрашивать для неё ничего не нужно — достаточно предъявить нужные учётные данные.

Зеркальные репозитории

Установка использует все доступные ей области доступа для нативного репозитория Origin. Для зеркального репозитория доступны только две области доступа:

• repository:metadata:read
• repository:contents:read

Все остальные области доступа возвращают 403 для этого репозитория независимо от того, что одобрил администратор рабочей области. Через REST API по-прежнему доступны чтение репозитория и содержимого, сравнение коммитов и синхронизация зеркала, а Origin отклоняет pull requests, ревью, комментарии, проверки, наборы правил и любые операции записи. Через Git по HTTPS по-прежнему работают clone, fetch, pull и скачивание LFS, а Origin отклоняет push и загрузку LFS.

Для изменения состояния зеркала репозитория нужны учётные данные пользователя — установка не может выполнить эту операцию: Transition Repo Mirror повторно запускает синхронизацию зеркала, если первоначальная синхронизация завершилась ошибкой, а Detach Repo Mirror окончательно отключает зеркало, превращая его в нативный репозиторий.

Считайте 403 источником истины, а не определяйте по mirror.status, разрешена ли запись.

Ограничение частоты запросов

В Origin API для каждого принципала действует общий балльный лимит, обновляемый в скользящем одноминутном окне. Для каждого типа аутентифицированного принципала установлен свой лимит:

Перед запуском обработчика каждая конечная точка списывает из этого лимита фиксированное количество баллов. Ошибки аутентификации и авторизации не расходуют баллы.

Cursor может увеличить поминутный лимит для отдельных приложений партнёров по дизайну. Свяжитесь с Cursor, если вашей интеграции требуется более высокий лимит.

Заголовки ответа

Тарифицируемые ответы и Получить сведения об ограничении частоты запросов включают:

X-RateLimit-Reset указывает на полное 60-секундное окно, отсчитываемое с момента ответа. Окно счётчика начинается с первого тарифицируемого запроса в серии, а не на границе календарной минуты.

Превышение лимита

Если запрос превышает лимит, API возвращает ответ HTTP 429 со следующими данными:

• Retry-After: количество секунд ожидания перед повторной попыткой (60)
• Те же заголовки X-RateLimit-*, при этом значение X-RateLimit-Remaining равно 0

{  "code": 8,  "message": "Rate limit exceeded: 3000 points per minute for this installation. Retry after 60s.",  "details": []}

Перед повторной попыткой дождитесь времени, указанного в Retry-After, или наступления X-RateLimit-Reset. Если несколько вызывающих сторон используют один токен установки, применяйте экспоненциальную задержку с джиттером.

Проверка оставшейся квоты

Вызовите Получить сведения об ограничении частоты запросов, чтобы узнать текущий лимит, не расходуя баллы. Тело ответа соответствует заголовкам X-RateLimit-* для общего ресурса core.

Общие соглашения

Пагинация

Конечные точки с поддержкой пагинации принимают:

• pageSize: по умолчанию — 30, максимум — 100.
• pageToken: непрозрачный токен, возвращённый предыдущей страницей. Не анализируйте и не формируйте его самостоятельно.

В ответах используются поле коллекции для конкретного ресурса и nextPageToken. Оно пусто, если следующей страницы нет. В ответах на публичные запросы списков общее количество не указывается. Токены страниц привязаны к исходному ресурсу и фильтрам. При изменении фильтров начните пагинацию заново. Недопустимые, несовпадающие или непустые токены, не соответствующие запросу, возвращают 400.

Передавайте одинаковый pageSize во всех запросах последовательности, включая запросы продолжения. Большинство конечных точек списков применяют pageSize, переданный вместе с токеном страницы, к этой странице, а если параметр не указан, сохраняют предыдущий размер страницы; это отмечено в описании их параметра pageToken. Остальные по-разному обрабатывают то, что запоминает токен страницы, поэтому, если pageSize не меняется, размер страницы будет одинаковым для всех конечных точек.

Ошибки

Для ошибок используется тело в стиле Google RPC:

{  "code": 5,  "message": "resource not found",  "details": []}

Распространённые коды состояния HTTP: 400, 401, 403, 404, 429, 500 и 503. Некоторые операции с базой данных Git также возвращают 409 при конфликтах состояния репозитория. См. Ограничения частоты запросов для заголовков 429 и поведения при повторных попытках.

Используйте код состояния HTTP и code для обработки ошибок. message предназначено для разработчиков.

404 не позволяет отличить несуществующий ресурс от ресурса, к которому ваше приложение не может получить доступ. Интерпретируйте его как "недоступен для этой установки", а не как доказательство отсутствия ресурса.

details содержит типизированные записи: сведения о нарушениях полей google.rpc.BadRequest при недопустимом аргументе и запись google.rpc.RequestInfo при каждой ошибке. Origin может в любой момент добавлять типы сведений, поэтому игнорируйте записи, которые ваша интеграция не распознаёт.

Каждый ответ с ошибкой содержит идентификатор запроса дважды: в заголовке ответа X-Request-ID и в записи google.rpc.RequestInfo в details. Origin возвращает отправленный вами x-request-id или генерирует его, если вы его не отправили. Запись RequestInfo присутствует даже если message содержит непрозрачную внутреннюю ошибку, поэтому при обращении в Cursor по поводу неудачного вызова укажите идентификатор запроса.

Несопоставленные пути в /v1/origin и запросы, использующие неверный метод для известного пути, возвращают это же тело вместо общей ошибки маршрутизатора. Сообщение указывает метод и путь и никогда не возвращает строку запроса.

Идентификаторы

Идентификаторы ресурсов — это непрозрачные строки с префиксом типа, например app_… для приложения и i_… для установки. Храните и сравнивайте их как цельные строки. Не разбирайте их, не пытайтесь извлечь смысл из составляющих их символов и не полагайтесь на порядок их сортировки.

Идентификатор не меняется на протяжении всего существования ресурса, тогда как имена и слаги могут меняться. При переименовании репозиторий сохраняет свой идентификатор, поэтому используйте в качестве ключа для кэшированных данных идентификатор, а не {ownerSlug}/{repoName}, и обращайтесь к репозиторию по идентификатору, как описано в разделе Пути репозитория.

Пути репозитория

В путях, ограниченных репозиторием, слаг владельца и имя репозитория указываются в формате {ownerSlug}/{repoName}. Оба сегмента обрабатываются без учёта регистра, поэтому к репозиторию можно обратиться при любом регистре. В ответах возвращаются сохранённые имя и слаг, а не указанный вами регистр; URL Git по HTTPS обрабатываются так же. Сравнивайте имена репозиториев без учёта регистра, а канонический вариант написания берите из Получить репозиторий.

Каждый путь, ограниченный репозиторием, также принимает стабильный идентификатор репозитория вместо этой пары: укажите _ в качестве слага владельца и идентификатор в качестве имени репозитория, например GET /v1/origin/repos/_/REPO_ID. Идентификатор берите из поля id в Получить репозиторий. Зарезервированный символ _ нельзя использовать в качестве слага владельца, поэтому эти две формы никогда не пересекаются. В запросе Connect или JSON задайте для ownerSlug значение _, а для name — идентификатор.

Форма с идентификатором сохраняется после переименования, поэтому это стабильный способ обратиться к репозиторию. Сам по себе идентификатор не предоставляет никаких прав: после того как Origin сопоставит идентификатор с репозиторием, вашему приложению всё равно нужна та же область действия для этого репозитория. Идентификатор, к которому ваше приложение не имеет доступа, возвращает то же тело 404, что и несуществующий идентификатор, поэтому ответ никогда не подтверждает существование репозитория. Некорректный идентификатор возвращает 400. Create Repo принимает только слаг владельца и отклоняет _.

Ссылки на ресурсы

Снимки ресурсов содержат актуальные значения полей ресурса. В контексте контейнера используются компактные ссылки вместо дублирования полных ресурсов:

• RepositoryReference указывает на репозиторий.
• PullRequestReference указывает на pull request и содержит ссылку на его репозиторий.
• ThreadReference указывает на тред, содержащий комментарий к pull request.
• OriginActor указывает на публичного инициатора как на один из вариантов: user, app или serviceAccount. Присутствует ровно один вариант; считывайте identity из этого варианта.

Запуски проверок

Apps сообщают результаты CI в виде наборов проверок и запусков проверки, привязанных к commit, через Post запуск проверки и Batch Upsert запусков проверки, а получают их обратно через конечные точки Checks. В этом разделе описаны общие для этих конечных точек понятия: какая попытка считается текущей, как Origin упорядочивает операции записи и сообщает о них, а также как ведут себя метка времени и сроки выполнения.

Попытки и текущая попытка

Каждая комбинация (actor, key, externalId, baseSha), сообщённая для коммита, — это одна попытка набора проверок, а каждая комбинация (suite, key, externalId) внутри неё — одна попытка запуска. Публикация без baseSha обращается к попытке, не привязанной к base-ветке, поэтому публикация того же externalId для другой base-ветки либо с указанием base-ветки и без него создаёт отдельные попытки. Повторное использование externalId с той же base-веткой обновляет эту попытку на месте; новый externalId начинает новую попытку, а предыдущая сохраняется в истории. Вытесненные попытки остаются доступны для чтения по id через Получить набор проверок и Получить запуск проверки.

Там, где API показывает текущие проверки коммита — в Списке наборов проверок для коммита, Списке запусков проверок для коммита, а также в состоянии CI pull request и обязательных проверках, — Origin сводит попытки в два шага:

1. Текущей попыткой набора проверок для пары (actor, key) считается та, чьи текущие запуски, выбранные на втором шаге, имеют самое свежее значение externalUpdatedAt; набор без запусков ранжируется по своему createdAt. При равенстве сравнивается createdAt набора, затем его id, от новых к старым.
2. Внутри этой попытки набора текущим запуском для key считается тот, у которого самое свежее externalUpdatedAt. При равенстве сравнивается createdAt, затем id, от новых к старым.

В списках для коммита попытки, сообщённые для разных значений baseSha, участвуют в общем отборе текущей попытки для своей пары (actor, key).

Список запусков проверок для набора применяет второй шаг к указанному вами набору. Запуск является текущим для своего коммита только тогда, когда его набор — текущая попытка набора проверок для этого коммита. Поскольку на первом шаге ранжируются целые попытки наборов, запуск, опубликованный в рамках вытесненной попытки набора, не попадает в проверки коммита, пока у другой попытки более свежее externalUpdatedAt; как только его метка времени становится самой свежей, его попытка набора становится текущей, и скрываются уже запуски другой попытки.

Отменённая попытка не вытесняет успешную. На каждом из двух шагов отменённая попытка ранжируется ниже других попыток с тем же key, если самая новая неотменённая попытка с этим key прошла успешно. Запуск считается успешным, если он имеет статус completed и результат success, neutral или skipped. Попытка набора проверок считается успешной, если все её текущие запуски прошли успешно, и отменённой, если все её текущие запуски имеют статус completed, хотя бы один из них — результат cancelled, а остальные прошли успешно. Когда запрашивается повторный прогон успешной попытки, отменённые попытки, у которых externalUpdatedAt не раньше времени запроса, снова ранжируются по своим меткам времени. Более новая отменённая попытка набора проверок всё же вытесняет более старую, если та не прошла полностью успешно.

Запуск, для которого запрошен повторный прогон, сохраняет своё место в качестве текущей попытки для своего key и отображается как ожидающий, пока не ответит владеющее им приложение: см. Rerequest Check Run.

Порядок записей

Origin упорядочивает публикации в один запуск — с одинаковыми externalId и key в наборе проверок — по checkRun.externalUpdatedAt с точностью до миллисекунды. Публикация применяется, только если её значение равно сохранённому у запуска externalUpdatedAt или больше него; пока есть незавершённый повторный запрос, порог поднимается до rerequestedAt. Равные значения применяются, поэтому побеждает более поздняя публикация — за двумя исключениями, которые тоже считаются устаревшими: публикация со статусом queued, in_progress или failing не может вновь открыть completed-запуск с той же меткой времени, а публикация с меткой времени, в точности равной сохранённой, игнорируется, пока задано rerequestedAt. Более новое значение применяется, в том числе повторно открывая completed-запуск, — за одним исключением, которое считается устаревшим независимо от метки времени: публикация completed с результатом cancelled не может заменить completed-запуск с результатом success, neutral или skipped.

Устаревшая публикация всё равно выполняется успешно. В ответ приходит HTTP 200 с сохранённым набором проверок и запуском, а не с опубликованными значениями, и updatedAt запуска не меняется. Каждый опубликованный запуск возвращается парой: checkRun — сохранённый запуск после вызова, и outcome — что запись с ним сделала. Post запуск проверки возвращает эту пару на верхнем уровне ответа, рядом с checkSuite. Batch Upsert запуск проверки возвращает по одной паре на каждый опубликованный запуск в results[], в порядке запроса, так что элемент batch несёт тот же результат по запуску, который одиночный вызов размещает inline. Читайте outcome или каждый results[].outcome, чтобы узнать, что сделала запись:

updatedAt не сдвигается при публикации unchanged или ignored_stale, поэтому по нему нельзя отличить одно от другого; это может только outcome. Нераспознанное значение трактуйте как «сохранённый запуск есть в ответе; была ли выполнена запись — неизвестно». В batch Origin применяет это правило к каждому запуску отдельно: устаревший запуск не приводит к сбою всего batch, а results[] содержит сохранённый запуск в соответствующей позиции с outcome ignored_stale.

В Batch Upsert запуск проверки поле верхнего уровня checkRuns[] устарело в пользу results[]. Оно по-прежнему заполняется теми же сохранёнными запусками в том же порядке, но не содержит outcome; используйте results[]. Это касается только batch: в Post запуск проверки полями верхнего уровня для чтения являются checkRun и outcome.

Метки времени и дедлайны

Публикация, у которой externalUpdatedAt, startedAt или completedAt опережает текущее время более чем на 60 секунд, возвращает InvalidArgument (HTTP 400). completedAt не должен предшествовать startedAt, если оба указаны в одной публикации. deadlineAt не должен опережать текущее время более чем на 24 часа.

Истекать может только выполняющийся запуск в состоянии in_progress или failing. После того как его deadlineAt прошёл, периодическая очистка завершает его с результатом timed_out, задаёт completedAt, если у запуска его не было, и доставляет repository.check_run.completed. Как и у любого завершённого запуска, при чтении запуска, завершённого по тайм-ауту, deadlineAt отсутствует. Истечение наступает не точно в момент дедлайна, а через несколько минут после него: по умолчанию очистка выполняется примерно каждые 30 минут — это эксплуатационный параметр, который может измениться, поэтому не полагайтесь на этот интервал. Запуск в состоянии queued не истекает никогда, как и запуск без deadlineAt. Публикация со статусом completed сбрасывает дедлайн. Завершая запуск по тайм-ауту, Origin не трогает externalUpdatedAt, поэтому более поздняя публикация с новым externalUpdatedAt по-прежнему применяется к запуску, завершённому по тайм-ауту. Если публикация повторно открывает запуск, завершённый по тайм-ауту, и не содержит собственного deadlineAt, к запуску возвращается истёкший дедлайн. Поэтому, когда запуск перейдёт в состояние in_progress или failing, следующая очистка снова завершит его по тайм-ауту. Чтобы запуск оставался открытым, передайте новый deadlineAt в этой публикации.

Текущие ограничения

• Получение списка репозиториев в пространстве имён и создание репозиториев не поддерживаются Partner API. Репозитории можно находить через установку.
• Сравнение коммитов возвращает сводные данные, а не встроенный список коммитов. У изменённых файлов есть собственная конечная точка с пагинацией: Список файлов сравнения.
• К тредам можно обращаться только для их разрешения. Конечная точка для прямого получения списка тредов отсутствует; читайте их из содержащихся в них комментариев.
• Вебхуки push не содержат полного списка коммитов.
• Слияние pull request поддерживается для нативных репозиториев Origin. Зеркальные репозитории отклоняются.
• Зеркальный репозиторий доступен установке только для чтения. См. Зеркальные репозитории.

Контрольный список реализации

• Храните приватный ключ Ed25519 в менеджере секретов и выполняйте ротацию ключей осознанно. См. Создание ключа подписи приложения.
• Проверяйте подтверждение установки в колбэках установки и считывайте идентификатор установки и state из его утверждений.
• Используйте краткоживущие JWT приложения и выпускайте токены установки непосредственно перед использованием.
• Для API с областью действия в пределах репозитория, записи check-run и Git HTTPS используйте токены установки, а не JWT приложения.
• Запрашивайте минимально необходимые области доступа и доступ к репозиторию.
• Считайте токены страниц непрозрачными и перезапускайте пагинацию при изменении фильтров.
• Поддерживайте значения key проверок стабильными и понятными. Для каждой повторной попытки используйте новый неизменяемый externalId, а для обновлений — возрастающие значения externalUpdatedAt.
• Считывайте outcome в каждом ответе Post Check Run и каждый results[].outcome в каждом ответе Batch Upsert Check Runs; устаревшая публикация возвращает 200 с сохранённым запуском. См. Запуски проверок.
• Проверяйте подписи вебхука по сырому телу запроса до его разбора.
• Дедуплицируйте доставки по webhook-id и обрабатывайте их асинхронно после возврата 2xx.
• Игнорируйте неизвестные поля JSON для прямой совместимости.

• Учитывайте заголовки Retry-After и X-RateLimit-*. Используйте Получить сведения об ограничении частоты запросов, чтобы отслеживать оставшиеся баллы, не расходуя их.

Справочник конечных точек

Полные схемы компонентов доступны в спецификации OpenAPI. В документе в качестве сервера указан https://api.cursor.com, определена схема безопасности HTTP Bearer bearerAuth, а для каждой операции перечислены коды ответов, которые она может вернуть, а также пример запроса и ответа. Кроме того, каждая операция содержит расширение x-origin-scopes: в scopes указана область доступа, необходимая для операции, а в tokenTypes — типы учётных данных, которые она принимает. Каждая схема полезной нагрузки вебхука содержит расширение x-origin-webhook-events со списком событий, при которых она доставляется, а элементы в статусе предварительной версии помечены x-cursor-visibility: PREVIEW. Параметры пути имеют те же имена, что используются в URL: ownerSlug и repoName. У каждой операции есть уникальный operationId; если одна операция обслуживает две формы URL, идентификатор второй формы получает суффикс _2, например OriginService_GetRepoTarball_2.

Во фрагментах JSON показаны значения-заполнители, соответствующие схемам. Описания полей ответа отражают схему OpenAPI и текущий контракт платформы.

Приложения и установки

curl --request GET \  --url 'https://api.cursor.com/v1/origin/rate_limit' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "resources": {    "core": {      "limit": 6000,      "remaining": 5994,      "reset": 1785682800,      "used": 6    }  },  "rate": {    "limit": 6000,    "remaining": 5994,    "reset": 1785682800,    "used": 6  }}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/app' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "id": "app_01k2ja2000e0080000000000a1",  "displayName": "CI Status Bot",  "webhookUrl": "https://ci.acme.dev/webhooks/origin",  "events": [    "pull_request.created",    "pull_request.merged"  ],  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "installationRedirectUris": [    "https://ci.acme.dev/origin/setup"  ],  "namespaceSlug": "acme",  "description": "Posts CI status on pull requests.",  "websiteUrl": "https://ci.acme.dev",  "defaultScopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/app/installations' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "installations": [    {      "id": "inst_01k2ja2000e0080000000000b2",      "appId": "app_01k2ja2000e0080000000000a1",      "target": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      },      "createdAt": "2026-08-01T09:30:00Z",      "updatedAt": "2026-08-02T14:45:00Z",      "repoSelectionMode": "selected",      "scopes": [        "repository:contents:read",        "repository:pull_requests:read"      ]    }  ]}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/app/installations/INSTALLATION_ID' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "id": "inst_01k2ja2000e0080000000000b2",  "appId": "app_01k2ja2000e0080000000000a1",  "target": {    "slug": "acme",    "id": "ns_01k2ja2000e0080000000000p3",    "type": "team"  },  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "repoSelectionMode": "selected",  "scopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}

curl --request DELETE \  --url 'https://api.cursor.com/v1/origin/app/installations/INSTALLATION_ID' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

204 No Content

curl --request POST \  --url 'https://api.cursor.com/v1/origin/app/installations/INSTALLATION_ID/access_tokens' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "scopes": [    "repository:contents:read",    "repository:pull_requests:read"  ],  "repositoryIds": [    "repo_01k2ja2000e0080000000000q4"  ]}'

{  "token": "oit_2v8xkq4m1c7p9t3w5y0z6r4b",  "expiresAt": "2026-08-01T10:30:00Z"}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/app/installations/INSTALLATION_ID/user_access_tokens' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "userId": "user_01k2ja2000e0080000000000c3",  "scopes": [    "repository:pull_requests:reviews:write"  ],  "repositoryIds": [    "repo_01k2ja2000e0080000000000q4"  ]}'

{  "token": "YOUR_INSTALLATION_USER_TOKEN",  "expiresAt": "2026-08-01T10:30:00Z"}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/installation/repos' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "repositories": [    {      "id": "repo_01k2ja2000e0080000000000q4",      "name": "rocket",      "fullName": "acme/rocket",      "owner": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      },      "defaultBranch": "main",      "createdAt": "2026-08-01T09:30:00Z",      "updatedAt": "2026-08-02T14:45:00Z",      "pushedAt": "2026-08-02T14:45:00Z",      "cloneUrl": "https://origin.cursor.com/git/acme/rocket.git"    }  ],  "repoSelectionMode": "selected"}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/app/webhook/deliveries' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "deliveries": [    {      "id": "whd_01k2ja2000e0080000000000j9",      "event": {        "id": "evt_01k2ja2000e0080000000000r5",        "type": "pull_request.created"      },      "installation": {        "id": "inst_01k2ja2000e0080000000000b2",        "target": {          "slug": "acme",          "id": "ns_01k2ja2000e0080000000000p3",          "type": "team"        }      },      "createdAt": "2026-08-01T09:30:00Z",      "deliveredAt": "2026-08-02T14:45:05Z",      "lastAttempt": {        "id": "wha_01k2ja2000e0080000000000k0",        "deliveryId": "whd_01k2ja2000e0080000000000j9",        "trigger": "automatic",        "responseStatusCode": 200,        "latencyMs": 182,        "attemptedAt": "2026-08-02T14:45:05Z"      }    }  ]}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/app/webhook/deliveries:batchRedeliver' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "deliveryIds": [    "whd_01k2ja2000e0080000000000j9"  ]}'

{  "results": [    {      "deliveryId": "whd_01k2ja2000e0080000000000j9",      "outcome": "queued"    }  ]}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/app/webhook/pings' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{}'

{  "deliveryId": "whd_01k2ja2000e0080000000000j9",  "eventId": "evt_01k2ja2000e0080000000000r5",  "delivered": true,  "responseStatusCode": 200}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/apps/{appId}' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "id": "app_01k2ja2000e0080000000000a1",  "displayName": "CI Status Bot",  "webhookUrl": "https://ci.acme.dev/webhooks/origin",  "events": [    "pull_request.created",    "pull_request.merged"  ],  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "installationRedirectUris": [    "https://ci.acme.dev/origin/setup"  ],  "namespaceSlug": "acme",  "description": "Posts CI status on pull requests.",  "websiteUrl": "https://ci.acme.dev",  "defaultScopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}

curl --request PATCH \  --url 'https://api.cursor.com/v1/origin/apps/APP_ID' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "webhookUrl": "https://ci.acme.dev/webhooks/origin-v2",  "events": {    "events": [      "pull_request.created",      "pull_request.merged",      "repository.pushed"    ]  }}'

{  "id": "app_01k2ja2000e0080000000000a1",  "displayName": "CI Status Bot",  "webhookUrl": "https://ci.acme.dev/webhooks/origin-v2",  "events": [    "pull_request.created",    "pull_request.merged",    "repository.pushed"  ],  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "installationRedirectUris": [    "https://ci.acme.dev/origin/setup"  ],  "namespaceSlug": "acme",  "description": "Posts CI status on pull requests.",  "websiteUrl": "https://ci.acme.dev",  "defaultScopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/apps/APP_ID/signing_keys' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "publicKey": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAq9zTf3hL6wXe1cVj0bYs5mKR8uDnG2oAaPp4NiEkKlM=\n-----END PUBLIC KEY-----"}'

{  "kid": "3q2xW9dK5fJm8vB1nY6cT0aZrQpLh4eGkVsN7uMxOdI",  "createdAt": "2026-08-02T14:45:00Z"}

curl --request DELETE \  --url 'https://api.cursor.com/v1/origin/apps/{appId}/signing_keys/{kid}' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

204 No Content

curl --request GET \  --url 'https://api.cursor.com/v1/origin/namespaces/{namespaceSlug}/apps' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "apps": [    {      "id": "app_01k2ja2000e0080000000000a1",      "displayName": "CI Status Bot",      "description": "Posts CI status on pull requests."    },    {      "id": "app_01k2ja2000e0080000000000a2",      "displayName": "Deploy Bot",      "description": ""    }  ],  "nextPageToken": ""}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/namespaces/NAMESPACE_SLUG/apps' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "displayName": "CI Status Bot",  "publicKey": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAv7wFoV1bC9yKq3nZ8dQmXh5uJb2tR4sEwG6aP0iN8kY=\n-----END PUBLIC KEY-----",  "webhookUrl": "https://ci.acme.dev/webhooks/origin",  "events": [    "pull_request.created",    "pull_request.merged"  ],  "description": "Posts CI status on pull requests.",  "websiteUrl": "https://ci.acme.dev",  "installationRedirectUris": [    "https://ci.acme.dev/origin/setup"  ],  "defaultScopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}'

{  "id": "app_01k2ja2000e0080000000000a1",  "displayName": "CI Status Bot",  "webhookUrl": "https://ci.acme.dev/webhooks/origin",  "events": [    "pull_request.created",    "pull_request.merged"  ],  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-01T09:30:00Z",  "installationRedirectUris": [    "https://ci.acme.dev/origin/setup"  ],  "namespaceSlug": "acme",  "description": "Posts CI status on pull requests.",  "websiteUrl": "https://ci.acme.dev",  "defaultScopes": [    "repository:contents:read",    "repository:pull_requests:read"  ]}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/namespaces/NAMESPACE_SLUG/installations/INSTALLATION_ID/repos' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "repoIds": [    "repo_01k2ja2000e0080000000000q4",    "repo_01k2ja2000e0080000000000q5"  ]}'

{  "id": "inst_01k2ja2000e0080000000000b2",  "appId": "app_01k2ja2000e0080000000000a1",  "target": {    "slug": "acme",    "id": "ns_01k2ja2000e0080000000000p3",    "type": "team"  },  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "repoSelectionMode": "selected",  "scopes": [    "repository:contents:read",    "repository:pull_requests:read",    "repository:metadata:read"  ]}

Репозитории

cloneUrl — URL для клонирования по HTTPS, доступный только для вывода. Получить репозиторий включает cloneUrl.

Партнёры находят свои репозитории через Список репозиториев установки приложения. Получение списка репозиториев в пространстве имён и их создание не входят в Partner API.

curl --request GET \  --url 'https://api.cursor.com/v1/origin/namespaces' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "namespaces": [    {      "namespace": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      },      "viewerCanCreateRepositories": true    },    {      "namespace": {        "slug": "jane",        "id": "ns_01k2ja2000e0080000000000p4",        "type": "user"      },      "viewerCanCreateRepositories": false    }  ]}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "repositories": [    {      "id": "repo_01k2ja2000e0080000000000q4",      "name": "rocket",      "fullName": "acme/rocket",      "owner": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      },      "defaultBranch": "main",      "createdAt": "2026-08-01T09:30:00Z",      "updatedAt": "2026-08-02T14:45:00Z",      "pushedAt": "2026-08-02T14:45:00Z",      "cloneUrl": "https://origin.cursor.com/git/acme/rocket.git"    }  ]}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "id": "repo_01k2ja2000e0080000000000q4",  "name": "rocket",  "fullName": "acme/rocket",  "owner": {    "slug": "acme",    "id": "ns_01k2ja2000e0080000000000p3",    "type": "team"  },  "defaultBranch": "main",  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "pushedAt": "2026-08-02T14:45:00Z",  "cloneUrl": "https://origin.cursor.com/git/acme/rocket.git"}

curl --request PATCH \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "defaultBranch": "main",  "allowMergeCommit": false,  "allowSquashMerge": true,  "deleteBranchOnMerge": true,  "visibility": "private"}'

{  "id": "repo_01k2ja2000e0080000000000q4",  "name": "rocket",  "fullName": "acme/rocket",  "owner": {    "slug": "acme",    "id": "ns_01k2ja2000e0080000000000p3",    "type": "team"  },  "defaultBranch": "main",  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "pushedAt": "2026-08-02T14:45:00Z",  "cloneUrl": "https://origin.cursor.com/git/acme/rocket.git",  "visibility": "private",  "allowMergeCommit": false,  "allowSquashMerge": true,  "deleteBranchOnMerge": true}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "name": "rocket",  "defaultBranch": "main"}'

{  "id": "repo_01k2ja2000e0080000000000q4",  "name": "rocket",  "fullName": "acme/rocket",  "owner": {    "slug": "acme",    "id": "ns_01k2ja2000e0080000000000p3",    "type": "team"  },  "defaultBranch": "main",  "createdAt": "2026-08-01T09:30:00Z",  "updatedAt": "2026-08-02T14:45:00Z",  "pushedAt": "2026-08-02T14:45:00Z",  "cloneUrl": "https://origin.cursor.com/git/acme/rocket.git"}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/branches' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "branches": [    {      "name": "main",      "commit": {        "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4"      }    }  ]}

curl --request GET \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/collaborators/USER_ID/permission' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "user": {    "id": "user_01k2ja2000e0080000000000c3",    "email": "jane@acme.dev",    "displayName": "Jane Doe"  },  "permission": "write"}

curl --request GET --location --output repo.tar.gz \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/tarball/HEAD' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

{  "downloadUrl": "https://artifacts.origin.cursor.com/tarballs/0192f7a4-6c1e-7b3a-9f21-3d54c9a7e6b0/9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4.tar.gz?Expires=1767225600&Signature=EXAMPLE&Key-Pair-Id=KEXAMPLE123",  "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4"}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME:syncMirror' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "ref": "refs/heads/main",  "wait": true}'

{  "synced": true}

Конечные точки перехода зеркал описаны в Origin Migration API. Синхронизация зеркала остаётся на этой странице.

Отключить зеркало репозитория

См. Отключить зеркало репозитория.

Получение задачи перехода зеркала

См. Получение задачи перехода зеркала.

Получение активной задачи перехода зеркала

См. Получение активной задачи перехода зеркала.

Transition Repo Mirror

См. Transition Repo Mirror.

Проверки

• При первом вызове upsert набор создаётся автоматически.
• Обязательные проверки сопоставляются с устанавливающим приложением, а также с key набора и, при необходимости, key запуска. name используется только для отображения и не участвует в сопоставлении.
• Сохраняйте значения key неизменными между попытками и понятными пользователям, так как на них основана конфигурация обязательных проверок.
• Повторно используйте externalId для обновления попытки — при этом её предыдущий результат удаляется; для повторной попытки используйте новый externalId, чтобы предыдущая попытка сохранилась в истории.
• Используйте checkRun.output для результатов, понятных человеку:
  • title: краткий заголовок результата, до 255 символов.
  • summary: основная сводка в Markdown, до 65 535 байт UTF-8.
  • text: расширенные сведения в Markdown, до 65 535 байт UTF-8.
• Используйте detailsUrl для ссылки на внешнюю страницу результатов поставщика.

Раздел Запуски проверок определяет, какая попытка считается текущей, как externalUpdatedAt упорядочивает записи и о чём сообщает outcome, а также правила меток времени и сроков, общие для этих конечных точек.

curl --request POST \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/check-runs' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "headSha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",  "checkSuite": {    "key": "ci-8842",    "name": "CI",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "externalId": "build-8842"  },  "checkRun": {    "key": "ci-8842-unit-tests",    "name": "unit-tests",    "status": "completed",    "conclusion": "success",    "externalUpdatedAt": "2026-08-02T14:44:30Z",    "startedAt": "2026-08-02T14:40:00Z",    "completedAt": "2026-08-02T14:44:30Z",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "externalId": "run-8842",    "output": {      "title": "Unit tests",      "summary": "128 tests passed.",      "text": "All suites green."    }  }}'

{  "checkSuite": {    "id": "crg_01k2ja2000e0080000000000h8",    "repository": {      "id": "repo_01k2ja2000e0080000000000q4",      "name": "rocket",      "owner": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      }    },    "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",    "key": "ci-8842",    "name": "CI",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "createdAt": "2026-08-01T09:30:00Z",    "updatedAt": "2026-08-02T14:45:00Z",    "externalId": "build-8842",    "actor": {      "user": {        "id": "user_01k2ja2000e0080000000000c3",        "email": "jane@acme.dev"      }    }  },  "checkRun": {    "id": "cr_01k2ja2000e0080000000000g7",    "repository": {      "id": "repo_01k2ja2000e0080000000000q4",      "name": "rocket",      "owner": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      }    },    "checkSuite": {      "id": "crg_01k2ja2000e0080000000000h8"    },    "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",    "key": "ci-8842-unit-tests",    "name": "unit-tests",    "status": "completed",    "conclusion": "success",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "externalUpdatedAt": "2026-08-02T14:44:30Z",    "startedAt": "2026-08-02T14:40:00Z",    "completedAt": "2026-08-02T14:44:30Z",    "createdAt": "2026-08-01T09:30:00Z",    "updatedAt": "2026-08-02T14:45:00Z",    "externalId": "run-8842",    "actor": {      "user": {        "id": "user_01k2ja2000e0080000000000c3",        "email": "jane@acme.dev"      }    },    "output": {      "title": "Unit tests",      "summary": "128 tests passed.",      "text": "All suites green."    }  },  "outcome": "created"}

curl --request POST \  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/check-runs:batchUpsert' \  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "headSha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",  "checkSuite": {    "key": "ci-8842",    "name": "CI",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "externalId": "build-8842"  },  "checkRuns": [    {      "key": "ci-8842-unit-tests",      "name": "unit-tests",      "status": "completed",      "conclusion": "success",      "externalUpdatedAt": "2026-08-02T14:44:30Z",      "startedAt": "2026-08-02T14:40:00Z",      "completedAt": "2026-08-02T14:44:30Z",      "detailsUrl": "https://ci.acme.dev/runs/8842",      "externalId": "run-8842",      "output": {        "title": "Unit tests",        "summary": "128 tests passed.",        "text": "All suites green."      }    }  ]}'

{  "checkSuite": {    "id": "crg_01k2ja2000e0080000000000h8",    "repository": {      "id": "repo_01k2ja2000e0080000000000q4",      "name": "rocket",      "owner": {        "slug": "acme",        "id": "ns_01k2ja2000e0080000000000p3",        "type": "team"      }    },    "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",    "key": "ci-8842",    "name": "CI",    "detailsUrl": "https://ci.acme.dev/runs/8842",    "createdAt": "2026-08-01T09:30:00Z",    "updatedAt": "2026-08-02T14:45:00Z",    "externalId": "build-8842",    "actor": {      "user": {        "id": "user_01k2ja2000e0080000000000c3",        "email": "jane@acme.dev"      }    }  },  "checkRuns": [    {      "id": "cr_01k2ja2000e0080000000000g7",      "repository": {        "id": "repo_01k2ja2000e0080000000000q4",        "name": "rocket",        "owner": {          "slug": "acme",          "id": "ns_01k2ja2000e0080000000000p3",          "type": "team"        }      },      "checkSuite": {        "id": "crg_01k2ja2000e0080000000000h8"      },      "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",      "key": "ci-8842-unit-tests",      "name": "unit-tests",      "status": "completed",      "conclusion": "success",      "detailsUrl": "https://ci.acme.dev/runs/8842",      "externalUpdatedAt": "2026-08-02T14:44:30Z",      "startedAt": "2026-08-02T14:40:00Z",      "completedAt": "2026-08-02T14:44:30Z",      "createdAt": "2026-08-01T09:30:00Z",      "updatedAt": "2026-08-02T14:45:00Z",      "externalId": "run-8842",      "actor": {        "user": {          "id": "user_01k2ja2000e0080000000000c3",          "email": "jane@acme.dev"        }      },      "output": {        "title": "Unit tests",        "summary": "128 tests passed.",        "text": "All suites green."      }    }  ],  "results": [    {      "checkRun": {        "id": "cr_01k2ja2000e0080000000000g7",        "repository": {          "id": "repo_01k2ja2000e0080000000000q4",          "name": "rocket",          "owner": {            "slug": "acme",            "id": "ns_01k2ja2000e0080000000000p3",            "type": "team"          }        },        "checkSuite": {          "id": "crg_01k2ja2000e0080000000000h8"        },        "sha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",        "key": "ci-8842-unit-tests",        "name": "unit-tests",        "status": "completed",        "conclusion": "success",        "detailsUrl": "https://ci.acme.dev/runs/8842",        "externalUpdatedAt": "2026-08-02T14:44:30Z",        "startedAt": "2026-08-02T14:40:00Z",        "completedAt": "2026-08-02T14:44:30Z",        "createdAt": "2026-08-01T09:30:00Z",        "updatedAt": "2026-08-02T14:45:00Z",        "externalId": "run-8842",        "actor": {          "user": {            "id": "user_01k2ja2000e0080000000000c3",            "email": "jane@acme.dev"          }        },        "output": {          "title": "Unit tests",          "summary": "128 tests passed.",          "text": "All suites green."        }      },      "outcome": "created"    }  ]}