find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/git-top:git-top-sync-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Git.Top Agent Sync API
  version: 0.1.0
  description: Agent-native GitHub project knowledge API for search, project lookup, alternatives, comparison, graph reasoning, quality, and schema discovery. High-confidence clients should inspect metadata.source, metadata.reason, trust fields, classification evidence, quality_signal_confidence, verification signals, and migration validation steps, and use require_d1=true when seed fallback should fail closed.
servers:
- url: https://git.top
  description: Production
- url: http://localhost:8787
  description: Local Worker
tags:
- name: Sync
paths:
  /api/sync/status:
    get:
      summary: Inspect sync cursor progress, freshness, health, and recent failures
      parameters:
      - name: detail
        in: query
        required: false
        description: 'Response detail level: summary (default) returns five queue items; full returns up to fifty'
        schema:
          type: string
      responses:
        '200':
          description: Sync status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SyncStatusResponse'
      tags:
      - Sync
      operationId: getApiSyncStatus
      x-operation-id-source: derived
components:
  schemas:
    SyncFreshnessSlo:
      type: object
      required:
      - hot_projects
      - whole_corpus
      properties:
        hot_projects:
          allOf:
          - $ref: '#/components/schemas/SyncFreshnessSloSegment'
          - type: object
            required:
            - target_hours
            properties:
              target_hours:
                type: integer
                minimum: 1
        whole_corpus:
          allOf:
          - $ref: '#/components/schemas/SyncFreshnessSloSegment'
          - type: object
            required:
            - target_basis
            properties:
              target_basis:
                type: string
                enum:
                - tier_policy
      additionalProperties: false
    SyncStatusResponse:
      type: object
      required:
      - detail
      - health
      - freshness
      - priority
      properties:
        detail:
          type: string
          enum:
          - summary
          - full
        health:
          type: string
        freshness:
          type: string
        cursor:
          type: object
          additionalProperties: true
        latest_success:
          type: object
          additionalProperties: true
        recent_failures:
          type: array
          items:
            type: object
            additionalProperties: true
        priority:
          type: object
          required:
          - policy
          - counts
          - refresh_due_counts
          - stale_counts
          - stale_rates
          - freshness_slo
          - capacity
          properties:
            policy:
              type: object
              properties:
                hot_target_days:
                  type: integer
                warm_target_days:
                  type: integer
                cold_target_days:
                  type: integer
            counts:
              type: object
              additionalProperties:
                type: integer
            refresh_due_counts:
              type: object
              additionalProperties:
                type: integer
            stale_counts:
              type: object
              additionalProperties:
                type: integer
            stale_rates:
              type: object
              additionalProperties:
                type: number
            freshness_slo:
              $ref: '#/components/schemas/SyncFreshnessSlo'
            capacity:
              type: object
              required:
              - scheduled_daily_capacity
              - required_daily_syncs
              - utilization
              - headroom
              - target_feasible
              properties:
                scheduled_runs_per_day:
                  type: integer
                refresh_limit_per_run:
                  type: integer
                scheduled_daily_capacity:
                  type: integer
                required_daily_syncs:
                  type: integer
                utilization:
                  type: number
                headroom:
                  type: integer
                target_feasible:
                  type: boolean
            priority_preview:
              type: array
              items:
                type: object
                additionalProperties: true
            refresh_due_preview:
              type: array
              items:
                type: object
                additionalProperties: true
        derived:
          type: object
          additionalProperties: true
      additionalProperties: true
    SyncFreshnessSloSegment:
      type: object
      required:
      - total
      - within_target
      - freshness_rate
      - target_rate
      - meets_target
      properties:
        total:
          type: integer
          minimum: 0
        within_target:
          type: integer
          minimum: 0
        freshness_rate:
          type: number
          minimum: 0
          maximum: 1
        target_rate:
          type: number
          minimum: 0
          maximum: 1
        meets_target:
          type: boolean
  securitySchemes:
    syncSecret:
      type: http
      scheme: bearer
      description: Admin endpoints require the SYNC_SECRET bearer token.
    feedbackSecret:
      type: http
      scheme: bearer
      description: Optional FEEDBACK_SECRET. Without it, proposals are validated and fingerprinted but not persisted.