{
  "openapi": "3.1.0",
  "info": {
    "title": "RightsGraph static metadata API",
    "version": "0.1.0",
    "description": "Read-only static JSON metadata endpoints for evidence-backed rights knowledge graph discovery. This API provides informational metadata only and is not legal advice or a legal guarantee. Always verify original source terms before use."
  },
  "servers": [
    {
      "url": "https://rightsgraph.dev"
    }
  ],
  "paths": {
    "/data/assets.json": {
      "get": {
        "summary": "List pilot asset metadata records",
        "description": "Returns evidence-backed pilot asset metadata. RightsGraph links to original source pages and does not re-host original media files by default.",
        "operationId": "listAssets",
        "responses": {
          "200": {
            "description": "Array of pilot asset metadata records",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Asset"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/sources.json": {
      "get": {
        "summary": "List reviewed source metadata",
        "description": "Returns source-level license and integration review metadata.",
        "operationId": "listSources",
        "responses": {
          "200": {
            "description": "Array of reviewed source metadata records",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Source"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/license-matrix.json": {
      "get": {
        "summary": "List license comparison metadata",
        "description": "Returns informational license comparison data for creator workflows.",
        "operationId": "listLicenseMatrix",
        "responses": {
          "200": {
            "description": "License comparison metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/topics.json": {
      "get": {
        "summary": "List topic metadata",
        "description": "Returns static topic graph metadata used by RightsGraph topic pages.",
        "operationId": "listTopics",
        "responses": {
          "200": {
            "description": "Topic metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/workflows.json": {
      "get": {
        "summary": "List creator workflow paths",
        "description": "Returns persona workflow paths aligned with the topic graph and safe source set.",
        "operationId": "listWorkflows",
        "responses": {
          "200": {
            "description": "Workflow path metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Get AI-readable site guide",
        "description": "Returns a plain-text guide for AI agents and crawlers.",
        "operationId": "getLlmsTxt",
        "responses": {
          "200": {
            "description": "AI-readable plain-text guide",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Asset": {
        "type": "object",
        "required": [
          "id",
          "title",
          "mediaType",
          "sourceName",
          "sourceUrl",
          "creator",
          "licenseLabel",
          "licenseUrl",
          "usageSummary",
          "attributionRequired",
          "attributionText",
          "thumbnailPermissionStatus",
          "thumbnailUrl",
          "originalAssetUrl",
          "evidenceQuote",
          "evidenceUrl",
          "lastVerified",
          "riskLevel",
          "recommendedUseCases"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "mediaType": {
            "type": "string",
            "enum": [
              "image",
              "video",
              "audio",
              "document",
              "other"
            ]
          },
          "sourceName": {
            "type": "string"
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri"
          },
          "creator": {
            "type": "string"
          },
          "licenseLabel": {
            "type": "string"
          },
          "licenseUrl": {
            "type": "string",
            "format": "uri"
          },
          "usageSummary": {
            "type": "string"
          },
          "attributionRequired": {
            "type": "boolean"
          },
          "attributionText": {
            "type": "string"
          },
          "thumbnailPermissionStatus": {
            "type": "string",
            "enum": [
              "allowed",
              "unclear",
              "not_allowed"
            ]
          },
          "thumbnailUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "originalAssetUrl": {
            "type": "string",
            "format": "uri"
          },
          "evidenceQuote": {
            "type": "string"
          },
          "evidenceUrl": {
            "type": "string",
            "format": "uri"
          },
          "lastVerified": {
            "type": "string",
            "format": "date"
          },
          "riskLevel": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          },
          "recommendedUseCases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "Source": {
        "type": "object",
        "description": "Source-level metadata shape. Exact fields may evolve during the MVP.",
        "additionalProperties": true
      }
    }
  }
}