FolderShareListResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ctlsurf-com/json-schema/ctlsurf-com-folder-share-list-response-schema.json",
  "title": "FolderShareListResponse",
  "description": "List of shares for a folder.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ctlsurf-com-shares-api-openapi.yml#/components/schemas/FolderShareListResponse",
  "properties": {
    "folder_id": {
      "type": "string",
      "format": "uuid",
      "title": "Folder Id"
    },
    "owner": {
      "$ref": "#/$defs/UserSummary"
    },
    "shares": {
      "items": {
        "$ref": "#/$defs/FolderShareResponse"
      },
      "type": "array",
      "title": "Shares"
    }
  },
  "type": "object",
  "required": [
    "folder_id",
    "owner",
    "shares"
  ],
  "$defs": {
    "FolderShareResponse": {
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "title": "Id"
        },
        "folder_id": {
          "type": "string",
          "format": "uuid",
          "title": "Folder Id"
        },
        "shared_with": {
          "$ref": "#/$defs/UserSummary"
        },
        "permission": {
          "$ref": "#/$defs/app__schemas__share__SharePermission"
        },
        "include_pages": {
          "type": "boolean",
          "title": "Include Pages"
        },
        "created_by": {
          "type": "string",
          "format": "uuid",
          "title": "Created By"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At"
        }
      },
      "type": "object",
      "required": [
        "id",
        "folder_id",
        "shared_with",
        "permission",
        "include_pages",
        "created_by",
        "created_at"
      ],
      "title": "FolderShareResponse",
      "description": "Folder share response with user details."
    },
    "UserSummary": {
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "title": "Id"
        },
        "email": {
          "type": "string",
          "title": "Email"
        }
      },
      "type": "object",
      "required": [
        "id",
        "email"
      ],
      "title": "UserSummary",
      "description": "Minimal user info for display in shares."
    },
    "app__schemas__share__SharePermission": {
      "type": "string",
      "enum": [
        "view",
        "edit",
        "admin"
      ],
      "title": "SharePermission",
      "description": "Permission levels for shared resources."
    }
  }
}