action id4i_list_all_public_documents {
  label: "List public documents"
  description: "Listing all public documents of an id4n"
  provider: id4i
  method: GET
  path: "/api/v1/public/documents/{id4n}"
  encoding: json
  input: {
    type: "object"
    properties: {
      id4n: {
        type: "string"
      }
      limit: {
        type: "integer"
        format: "int32"
      }
      offset: {
        type: "integer"
        format: "int32"
      }
      organizationId: {
        type: "string"
      }
      owner: {
        type: "string"
      }
    }
    required: ["id4n"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["elements", "limit", "offset"]
    properties: {
      elements: {
        type: "array"
        items: {
          type: "object"
          properties: {
            filename: {
              type: "string"
              description: "File Name"
            }
            mimeType: {
              type: "string"
              description: "Mime Type"
            }
            ownerOrganizationId: {
              type: "string"
              description: "The organization's namespace which owns the document"
            }
            visibility: {
              type: "object"
              properties: {
                public: {
                  type: "boolean"
                  description: "Document is publicly readable (if ID4N is owned by the same organization)"
                }
                sharedOrganizationIds: {
                  type: "array"
                  description: "Document is readable by these organizations (independend of ID4N ownership)"
                  items: {
                    type: "string"
                  }
                }
              }
            }
          }
        }
      }
      limit: {
        type: "integer"
        format: "int32"
        description: "The number of returned elements"
      }
      offset: {
        type: "integer"
        format: "int32"
        description: "Starting with the n-th element"
      }
      total: {
        type: "integer"
        format: "int32"
        description: "The total number of elements"
      }
    }
  }
}