action files_get_groups {
  label: "List Groups"
  description: "List Groups"
  provider: files
  method: GET
  path: "/groups"
  encoding: json
  input: {
    type: "object"
    properties: {
      cursor: {
        type: "string"
      }
      filter: {
        type: "object"
      }
      filter_gt: {
        type: "object"
      }
      filter_gteq: {
        type: "object"
      }
      filter_like: {
        type: "object"
      }
      filter_lt: {
        type: "object"
      }
      filter_lteq: {
        type: "object"
      }
      ids: {
        type: "string"
      }
      per_page: {
        type: "integer"
        format: "int32"
      }
      sort_by: {
        type: "object"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      description: "List Groups"
      properties: {
        admin_ids: {
          type: "string"
          description: "Comma-delimited list of user IDs who are group administrators (separated by commas)"
        }
        id: {
          type: "integer"
          format: "int32"
          description: "Group ID"
        }
        name: {
          type: "string"
          description: "Group name"
        }
        notes: {
          type: "string"
          description: "Notes about this group"
        }
        user_ids: {
          type: "string"
          description: "Comma-delimited list of user IDs who belong to this group (separated by commas)"
        }
        usernames: {
          type: "string"
          description: "Comma-delimited list of usernames who belong to this group (separated by commas)"
        }
      }
    }
  }
}