SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Connect a GitHub repository to a website

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/code/repos

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

connection_idstringrequired

GitHub connection id, from the connections listed in SEO settings.

repo_full_namestringrequired

owner/name.

default_branchstring

Branch to audit and target, default main.

visibilitystring

private, tenant or shared. Send tenant so a plain API key keeps seeing it.

Response

Response Body

idstringConnected repository id. Use it as repo_id.
site_idstringWebsite the repository belongs to.
connection_idstring | nullGitHub connection used to read and write it.
providerstringAlways github today.
repo_full_namestringowner/name on GitHub.
default_branchstringBranch audits read and pull requests target.
frameworkstring | nullFramework detected by the last audit.
last_audit_atstring | nullWhen the repository was last audited.
visibilitystringprivate, tenant or shared.
created_atstringWhen it was connected.
latestobject | nullMost recent audit summary for this repository, or null.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/code/repos \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"connection_id": "7b2f4c1a-5d3e-4f60-9a8b-1c2d3e4f5a6b",
"repo_full_name": "acme/bakery-site",
"default_branch": "main",
"visibility": "tenant"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
"data": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"connection_id": null,
"provider": "github",
"repo_full_name": "acme/bakery-site",
"default_branch": "main",
"framework": "astro",
"last_audit_at": null,
"visibility": "tenant",
"created_at": "2026-09-01T09:00:00.000Z",
"latest": {
"status": "completed",
"score": 72
}
}
}