aVenture APIRepositories

Sync entity repositories from GitHub

View as Markdown
Fetches repositories from GitHub for the entity's current github URL links and replaces the entity's synced rows. Returns the full synced list ordered by stargazers. 404 when the entity has no current github URL link.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

Path parameters

entityIdstringRequiredformat: "uuid"
Entity UUID owning the repositories

Response

OK
forkCountinteger
githubIdlong

GitHub’s stable numeric repository id; sync upsert key per owner

idlong
isArchivedboolean
True when the repository is archived on GitHub
isForkboolean
True when the repository is a fork of another repository
namestring

Repository name (slug segment after the login)

ownerLoginstring

GitHub account login (org or user) the repository belongs to

stargazerCountinteger
topiclist of strings
Repository topics reported by GitHub
urlstring
Canonical https GitHub repository page URL
createdAtdatetime or nullOptional
descriptionstring or nullOptional
homepageUrlstring or nullOptional
Project homepage URL declared on the repository
languagestring or nullOptional
Primary language reported by GitHub
licensestring or nullOptional
SPDX license id reported by GitHub
repoCreatedAtdatetime or nullOptional

GitHub created_at of the repository

repoPushedAtdatetime or nullOptional

GitHub pushed_at of the repository at last sync

updatedAtdatetime or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error