{
  "schema": "kallipolis.resource-quality.v1",
  "id": "resource.connector.github-rest-api",
  "version": "1.0.0",
  "title": "GitHub REST API connector boundary",
  "summary": "Official-source public-read, token, fine-grained permission, GitHub App, workflow-token, and write-operation boundaries for GitHub connectors.",
  "content": {
    "kind": "connector-boundary",
    "facts": [
      {
        "id": "fact.github.rest-auth.read",
        "statement": "Some GitHub REST endpoints expose public information without authentication, while authenticated requests can access additional endpoints and rate limits.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.github.rest-auth"
        ]
      },
      {
        "id": "fact.github.rest-auth.write",
        "statement": "Write operations require the endpoint's declared token permissions and remain separate from repository, organization, branch, or environment policy.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.github.rest-auth"
        ]
      },
      {
        "id": "fact.github.rest-auth.auth",
        "statement": "GitHub supports personal access tokens, GitHub App tokens, and workflow GITHUB_TOKEN credentials; fine-grained tokens are recommended where supported.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.github.rest-auth"
        ]
      },
      {
        "id": "fact.github.rest-auth.boundary",
        "statement": "A token is an identity-bearing secret, and endpoint documentation plus accepted permissions must be checked before every read or mutation is exposed.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.github.rest-auth"
        ]
      }
    ]
  },
  "language": "en",
  "category": "enterprise-application-connector",
  "state": "prepared",
  "canonicalUrl": "https://platoskallipolis.com/resources/enterprise-application-connectors/github-rest-api.json",
  "contentHash": "sha256:58fde488558a7b1f078f33322348c0bf206c7f79af88609ee065d62bc4279963",
  "owner": {
    "id": "platos-kallipolis",
    "name": "Plato's Kallipolis",
    "type": "organization",
    "accountabilityUrl": "https://platoskallipolis.com/about"
  },
  "access": {
    "mode": "public",
    "url": "https://platoskallipolis.com/resources/enterprise-application-connectors/github-rest-api.json",
    "authentication": "none",
    "robotsAllowed": true
  },
  "provenance": {
    "method": "primary-source",
    "sources": [
      {
        "id": "source.github.rest-auth",
        "url": "https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api?apiVersion=2026-03-10",
        "title": "Authenticating to the REST API",
        "publisher": "GitHub",
        "observedAt": "2026-08-27T01:30:00Z"
      }
    ]
  },
  "observedAt": "2026-08-27T01:30:00Z",
  "freshness": {
    "policy": "max-age",
    "state": "current",
    "nextReviewAt": "2026-09-03T01:30:00Z",
    "maxAgeSeconds": 604800
  },
  "license": {
    "id": "source-terms-apply",
    "url": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
    "redistributionAllowed": false
  },
  "evidence": [
    {
      "id": "evidence.github.rest-auth",
      "type": "source-claim",
      "url": "https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api?apiVersion=2026-03-10",
      "observedAt": "2026-08-27T01:30:00Z"
    }
  ]
}
