{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/callidus-legal-ai/json-schema/callidus-legal-ai-permission-list-response-schema.json",
  "title": "PermissionListResponse",
  "description": "Response model for listing permissions.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/callidus-legal-ai-authorization-api-openapi.yml#/components/schemas/PermissionListResponse",
  "properties": {
    "members": {
      "items": {
        "$ref": "#/$defs/PermissionMemberResponse"
      },
      "type": "array",
      "title": "Members",
      "description": "List of members/permissions for a resource"
    },
    "resources": {
      "items": {
        "$ref": "#/$defs/UserResourceResponse"
      },
      "type": "array",
      "title": "Resources",
      "description": "List of resources a user has access to"
    },
    "subject_permission": {
      "anyOf": [
        {
          "$ref": "#/$defs/SubjectPermissionResponse"
        },
        {
          "type": "null"
        }
      ],
      "description": "Permission info for a specific subject on a specific resource (Mode 3)"
    },
    "total": {
      "type": "integer",
      "title": "Total",
      "description": "Total count of items",
      "default": 0
    }
  },
  "type": "object",
  "$defs": {
    "PermissionMemberResponse": {
      "properties": {
        "subject_type": {
          "type": "integer",
          "title": "Subject Type",
          "description": "Subject type: 1=USER, 2=TEAM"
        },
        "subject_type_name": {
          "type": "string",
          "title": "Subject Type Name",
          "description": "Human-readable subject type name"
        },
        "subject_id": {
          "type": "string",
          "title": "Subject Id",
          "description": "ID of the subject"
        },
        "relation": {
          "type": "integer",
          "title": "Relation",
          "description": "Relation type: 1=OWNER, 2=EDITOR, 3=VIEWER"
        },
        "relation_name": {
          "type": "string",
          "title": "Relation Name",
          "description": "Human-readable relation name"
        },
        "permissions": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Permissions",
          "description": "List of derived permissions (can_view, can_edit, etc.)"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created At",
          "description": "When the permission was created (ISO format)"
        },
        "created_by": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created By",
          "description": "Who created this permission"
        }
      },
      "type": "object",
      "required": [
        "subject_type",
        "subject_type_name",
        "subject_id",
        "relation",
        "relation_name"
      ],
      "title": "PermissionMemberResponse",
      "description": "Response model for a single permission/member entry."
    },
    "SubjectPermissionResponse": {
      "properties": {
        "subject_type": {
          "type": "integer",
          "title": "Subject Type",
          "description": "Subject type: 1=USER, 2=TEAM"
        },
        "subject_type_name": {
          "type": "string",
          "title": "Subject Type Name",
          "description": "Human-readable subject type name"
        },
        "subject_id": {
          "type": "string",
          "title": "Subject Id",
          "description": "ID of the subject"
        },
        "resource_type": {
          "type": "integer",
          "title": "Resource Type",
          "description": "Resource type: 1=MATTER, 2=CONVERSATION, 3=DATASET, 4=DOCUMENT"
        },
        "resource_type_name": {
          "type": "string",
          "title": "Resource Type Name",
          "description": "Human-readable resource type name"
        },
        "resource_id": {
          "type": "string",
          "title": "Resource Id",
          "description": "ID of the resource"
        },
        "relation": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Relation",
          "description": "Relation type: 1=OWNER, 2=EDITOR, 3=VIEWER (None if no direct grant)"
        },
        "relation_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Relation Name",
          "description": "Human-readable relation name"
        },
        "permissions": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Permissions",
          "description": "List of derived permissions (can_view, can_edit, etc.)"
        },
        "has_access": {
          "type": "boolean",
          "title": "Has Access",
          "description": "Whether the subject has any access to the resource"
        }
      },
      "type": "object",
      "required": [
        "subject_type",
        "subject_type_name",
        "subject_id",
        "resource_type",
        "resource_type_name",
        "resource_id",
        "has_access"
      ],
      "title": "SubjectPermissionResponse",
      "description": "Response model for checking a specific subject's permissions on a resource."
    },
    "UserResourceResponse": {
      "properties": {
        "resource_type": {
          "type": "integer",
          "title": "Resource Type",
          "description": "Resource type: 1=MATTER, 2=CONVERSATION, 3=DATASET, 4=DOCUMENT"
        },
        "resource_type_name": {
          "type": "string",
          "title": "Resource Type Name",
          "description": "Human-readable resource type name"
        },
        "resource_id": {
          "type": "string",
          "title": "Resource Id",
          "description": "ID of the resource"
        },
        "relation": {
          "type": "integer",
          "title": "Relation",
          "description": "Relation type: 1=OWNER, 2=EDITOR, 3=VIEWER"
        },
        "relation_name": {
          "type": "string",
          "title": "Relation Name",
          "description": "Human-readable relation name"
        },
        "permissions": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Permissions",
          "description": "List of derived permissions (can_view, can_edit, etc.)"
        }
      },
      "type": "object",
      "required": [
        "resource_type",
        "resource_type_name",
        "resource_id",
        "relation",
        "relation_name"
      ],
      "title": "UserResourceResponse",
      "description": "Response model for a resource that a user has access to."
    }
  }
}